Quickstart

Connect your systems to the jobs and candidates in your CVViZ account. Start with a read request, then follow a guide for the workflow you want to build.

1. Get access and create a credential

Your account needs API access through its plan or an active API add-on. An authorized administrator can open Settings > Developers, choose Create credential, and select View jobs (jobs.read) for this example.

Copy the secret immediately: it is shown only once. Keep it on your server, never in browser code, public repositories, logs or support messages.

2. Send your first request

The base URL is https://api.cvviz.com/v1. Paths such as /jobs are relative to it.

curl --request GET \
 --url 'https://api.cvviz.com/v1/jobs?page=1&pageSize=10' \
 --header 'Authorization: Bearer YOUR_API_SECRET' \
 --header 'Accept: application/json'

Replace YOUR_API_SECRET locally. This reads jobs; it does not create or modify them.

3. Understand the response

A successful request returns 200. Collections contain a data array and pagination metadata. An account with no matching jobs can return:

{
 "data": [],
 "meta": { "pagination": { "page": 1, "pageSize": 10, "totalItems": 0, "totalPages": 0 } }
}

The default page size is 10 and the maximum is 100. Save the X-Request-ID response header if you need support.

4. Choose your next task

• Create a job.

• Find candidates and download resumes.

• Pagination & filtering.

• Authentication & permissions.

• Rate limits & usage.

• Errors & troubleshooting.

• Safe retries & idempotency.

What is available?

Read jobs, candidates, applications, screening information, notes, tags and other documented resources. Selected write operations support jobs, candidate profiles, application stages, notes, tags and tasks.

Candidate creation, general document upload/download management and resume imports remain unpublished. Job creation and updates support optional career-page and eligible free-job-board publication; individual boards are not selectable. Free-job-board publication defaults to off on each create/update request. Offer sending, destructive job deletion and webhook management are not supported by this API.