CV-Transformer API reference

With the CV-Transformer API you can access and manage your data in a programmatic way, using HTTP requests. The structure of the CV Transformer API is based on PostgREST v13 .

Authentication

The CV-Transformer API uses api keys for authentication. You can create and manage API keys from the bottom of settings page of your organization in the admin dashboard .
Once you have an API key simply provide it in the HTTP Authorization header as bearer token.

Example
curl -X GET "https://api.cv-transformer.com/v1/layouts" \
  -H "Authorization: Bearer YOUR_API_KEY"

Selecting data

For each endpoint, you can select which columns you want to retrieve by using the select query parameter. Besides the columns of the resource itself, you can also select columns from related resources. For more advanced selection options refer to the PostgREST documentation .

Selecting all columns
curl -X GET "https://api.cv-transformer.com/v1/layouts?select=*" \
  -H "Authorization: Bearer YOUR_API_KEY"
Selecting specific columns
curl -X GET "https://api.cv-transformer.com/v1/layouts?select=id,name" \
  -H "Authorization: Bearer YOUR_API_KEY"
Including data from related tables
curl -X GET "https://api.cv-transformer.com/v1/layouts?select=name,candidates(*)" \
  -H "Authorization: Bearer YOUR_API_KEY"

Filtering

Filters can be applied on each list, update and delete request, to restrict the rows affected by the request. For a complete list of filters refer to the PostgREST documentation .

Listing active candidates
curl -X GET "https://api.cv-transformer.com/v1/candidates?status=eq.active" \
  -H "Authorization: Bearer YOUR_API_KEY"
Filtering by multiple columns
curl -X GET "https://api.cv-transformer.com/v1/candidates?data->>email=eq.some@example.com&status=eq.active" \
  -H "Authorization: Bearer YOUR_API_KEY"
Deleting test candidates
curl -X DELETE "https://api.cv-transformer.com/v1/candidates?data->>email=like.%test.com" \
  -H "Authorization: Bearer YOUR_API_KEY"

Sorting & pagination

By default, results are sorted by the primary key of the underlying table. You can change the sorting by using the order query parameter. To limit the number of results, use the limit and offset query parameters. The API will return at most 1000 results per request. For more advanced sorting and pagination options refer to the PostgREST documentation .

Sorting by creation date
curl -X GET "https://api.cv-transformer.com/v1/layouts?order=created_at.desc" \
  -H "Authorization: Bearer YOUR_API_KEY"
Limiting the number of results
curl -X GET "https://api.cv-transformer.com/v1/layouts?limit=10&offset=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

Api key usage

Endpoints
GET/api_key_usage

The api key usage object

Attributes

idinteger

Unique identifier

api_key_iduuid
api_keys.id

Identifier of the related API key

created_attimestamp with time zone

Creation timestamp

created_ondate

Date on which the API key was used

endpointtext

API endpoint that was called

methodtext

Request method

searchtext

Search params passed to the API request

The api key usage object

JSON

{
  "id": 0,
  "api_key_id": "00000000-0000-0000-0000-000000000000",
  "created_at": "2026-02-28T02:12:33.428Z",
  "created_on": null,
  "endpoint": "",
  "method": "",
  "search": ""
}

List api key usage

Filters

idFilter<integer>

Unique identifier

api_key_idFilter<uuid>
api_keys.id

Identifier of the related API key

created_atFilter<timestamp with time zone>

Creation timestamp

created_onFilter<date>

Date on which the API key was used

endpointFilter<text>

API endpoint that was called

methodFilter<text>

Request method

searchFilter<text>

Search params passed to the API request

Responses

200

A list of api key usage with the selected columns

206

Partial Content

GET /api_key_usage
curl -X GET "https://api.cv-transformer.com/v1/api_key_usage?select=*" \
  -H "Authorization: Bearer YOUR_API_KEY"

Billing accounts

Endpoints
GET/billing_accountsPATCH/billing_accounts

The billing account object

Attributes

iduuid

Unique identifier

paddle_subscription_idtext | null

Identifier of the subscription in Paddle

created_attimestamp with time zone

Creation timestamp

updated_attimestamp with time zone

Last modification timestamp

creditinteger

Amount of credits currently available

currencyCurrencyCode

Currency in which the organization is billed

minimum_guaranteeinteger

Minimum billed usage per month

next_billed_attimestamp with time zone | null

Next billing timestamp

prev_usageinteger

Number of credits used in previous 7 days

price_per_creditinteger

Agreed price per credit

pricing_versionPricingVersion

The organization's pricing version

recent_usageinteger

Number of credits used in the last 7 days

subscription_typeSubscriptionType

Active subscription type

trial_expires_attimestamp with time zone | null

Trial expiration timestamp

The billing account object

JSON

{
  "id": "00000000-0000-0000-0000-000000000000",
  "paddle_subscription_id": "",
  "created_at": "2026-02-28T02:12:33.431Z",
  "updated_at": "2026-02-28T02:12:33.431Z",
  "credit": 0,
  "currency": "USD",
  "minimum_guarantee": 0,
  "next_billed_at": "2026-02-28T02:12:33.431Z",
  "prev_usage": 0,
  "price_per_credit": 150,
  "pricing_version": "v3",
  "recent_usage": 0,
  "subscription_type": "subscription",
  "trial_expires_at": "2026-02-28T02:12:33.431Z"
}

List billing accounts

Filters

idFilter<uuid>

Unique identifier

paddle_subscription_idFilter<text | null>

Identifier of the subscription in Paddle

created_atFilter<timestamp with time zone>

Creation timestamp

updated_atFilter<timestamp with time zone>

Last modification timestamp

creditFilter<integer>

Amount of credits currently available

currencyFilter<CurrencyCode>

Currency in which the organization is billed

minimum_guaranteeFilter<integer>

Minimum billed usage per month

next_billed_atFilter<timestamp with time zone | null>

Next billing timestamp

prev_usageFilter<integer>

Number of credits used in previous 7 days

price_per_creditFilter<integer>

Agreed price per credit

pricing_versionFilter<PricingVersion>

The organization's pricing version

recent_usageFilter<integer>

Number of credits used in the last 7 days

subscription_typeFilter<SubscriptionType>

Active subscription type

trial_expires_atFilter<timestamp with time zone | null>

Trial expiration timestamp

Responses

200

A list of billing accounts with the selected columns

206

Partial Content

GET /billing_accounts
curl -X GET "https://api.cv-transformer.com/v1/billing_accounts?select=*" \
  -H "Authorization: Bearer YOUR_API_KEY"

Update billing accounts

Filters

idFilter<uuid>

Unique identifier

paddle_subscription_idFilter<text | null>

Identifier of the subscription in Paddle

created_atFilter<timestamp with time zone>

Creation timestamp

updated_atFilter<timestamp with time zone>

Last modification timestamp

creditFilter<integer>

Amount of credits currently available

currencyFilter<CurrencyCode>

Currency in which the organization is billed

minimum_guaranteeFilter<integer>

Minimum billed usage per month

next_billed_atFilter<timestamp with time zone | null>

Next billing timestamp

prev_usageFilter<integer>

Number of credits used in previous 7 days

price_per_creditFilter<integer>

Agreed price per credit

pricing_versionFilter<PricingVersion>

The organization's pricing version

recent_usageFilter<integer>

Number of credits used in the last 7 days

subscription_typeFilter<SubscriptionType>

Active subscription type

trial_expires_atFilter<timestamp with time zone | null>

Trial expiration timestamp

Body

Partial<BillingAccount>

Responses

204

The updated billing accounts with the selected columns

PATCH /billing_accounts
curl -X PATCH "https://api.cv-transformer.com/v1/billing_accounts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{}'

Candidate analytics

Endpoints
GET/candidate_analytics

The candidate analytic object

Attributes

iduuid

Unique identifier

candidate_iduuid | null
candidates.id

Identifier of the related candidate

organization_iduuid | null
organizations.id

Identifier of the related organization

created_attimestamp with time zone

Creation timestamp

updated_attimestamp with time zone

Last update timestamp

time_spentreal

Time spent in seconds

The candidate analytic object

JSON

{
  "id": "00000000-0000-0000-0000-000000000000",
  "candidate_id": "00000000-0000-0000-0000-000000000000",
  "organization_id": "00000000-0000-0000-0000-000000000000",
  "created_at": "2026-02-28T02:12:33.432Z",
  "updated_at": "2026-02-28T02:12:33.432Z",
  "time_spent": 0
}

List candidate analytics

Filters

idFilter<uuid>

Unique identifier

candidate_idFilter<uuid | null>
candidates.id

Identifier of the related candidate

organization_idFilter<uuid | null>
organizations.id

Identifier of the related organization

created_atFilter<timestamp with time zone>

Creation timestamp

updated_atFilter<timestamp with time zone>

Last update timestamp

time_spentFilter<real>

Time spent in seconds

Responses

200

A list of candidate analytics with the selected columns

206

Partial Content

GET /candidate_analytics
curl -X GET "https://api.cv-transformer.com/v1/candidate_analytics?select=*" \
  -H "Authorization: Bearer YOUR_API_KEY"

Candidate views

Logs for each time a candidate is viewed

Endpoints
GET/candidate_views

The candidate view object

Attributes

idbigint

Unique identifier

candidate_iduuid
candidates.id

Identifier of the related candidate

created_attimestamp with time zone

Creation timestamp

anonymousboolean

Whether the candidate was viewed with personal information redacted or not

The candidate view object

JSON

{
  "id": 0,
  "candidate_id": "00000000-0000-0000-0000-000000000000",
  "created_at": "2026-02-28T02:12:33.433Z",
  "anonymous": false
}

List candidate views

Filters

idFilter<bigint>

Unique identifier

candidate_idFilter<uuid>
candidates.id

Identifier of the related candidate

created_atFilter<timestamp with time zone>

Creation timestamp

anonymousFilter<boolean>

Whether the candidate was viewed with personal information redacted or not

Responses

200

A list of candidate views with the selected columns

206

Partial Content

GET /candidate_views
curl -X GET "https://api.cv-transformer.com/v1/candidate_views?select=*" \
  -H "Authorization: Bearer YOUR_API_KEY"

Candidates

All information related to individual candidates

Endpoints
GET/candidatesDELETE/candidatesPATCH/candidatesPOST/candidatesPOST/candidates/[candidate_id]/attachPOST/candidates/[candidate_id]/fillPOST/candidates/[candidate_id]/extract

The candidate object

Attributes

iduuid

Unique identifier

current_event_iduuid | null
layout_iduuid | null
layouts.id

Identifier of the related layout

member_iduuid | null
members.id

Identifier of the member associated with this candidate (initially the creator)

organization_iduuid
organizations.id

Identifier of the related organization

created_attimestamp with time zone

Creation timestamp

updated_attimestamp with time zone

Last modification timestamp

deleted_attimestamp with time zone | null

Deletion timestamp

attachmentsRecord<string, CandidateAttachment>

Files attached to this candidate (CV, Vacancy, other)

avatartext | null

The candidate's avatar image. Used for efficient display. Automatically filled when editing candidate from UI

export_filenametext

Filename for exported PDF file (without .pdf). If left empty, layout.export_filename applies.

external_dataCandidateExternalData | null

Data imported from an external source

ftstsvector
languageLanguage

Language this candidate should be displayed in

messagesArray<CandidateMessage>

List of messages exchanged with AI

nametext

The candidate's name. Used for searching. Automatically filled when editing candidate from UI

secrettext

Secret string. Used to privately share a proposal for this candidate with personal information non-redacted

secret_anonymoustext

Secret string. Used to privately share a proposal for this candidate with personal information redacted

secret_editabletext

Secret string. Used to share the candidate for editing.

section_attachmentsRecord<string, Array<string>>

Links of attachments per attachment section

statusCandidateStatus

Status of the candidate. Only active candidates can be shared

valuesJsonObject

Values for the each of the variables defined in the layout the candidate uses

The candidate object

JSON

{
  "id": "00000000-0000-0000-0000-000000000000",
  "current_event_id": "00000000-0000-0000-0000-000000000000",
  "layout_id": "00000000-0000-0000-0000-000000000000",
  "member_id": "00000000-0000-0000-0000-000000000000",
  "organization_id": "00000000-0000-0000-0000-000000000000",
  "created_at": "2026-02-28T02:12:33.434Z",
  "updated_at": "2026-02-28T02:12:33.434Z",
  "deleted_at": "2026-02-28T02:12:33.434Z",
  "attachments": {
    "CV": {
      "detected_source_language": null,
      "external_id": null,
      "label": "CV",
      "text": {
        "default": "Text from the attachment"
      },
      "type": "pdf",
      "url": "https://example.com/document.pdf"
    }
  },
  "avatar": "",
  "export_filename": "",
  "external_data": {
    "avatar": "https://example.com/candidates/123/avatar.jpg",
    "name": "John Doe",
    "id": "123",
    "url": "https://integration.com/candidates/123",
    "values": {
      "first_name": "John",
      "last_name": "Doe"
    }
  },
  "language": "en",
  "messages": [
    {
      "comment": "Filled in values",
      "created_at": "2026-02-28T02:12:28.925Z",
      "id": "00000000-0000-0000-0000-000000000000",
      "member_id": "00000000-0000-0000-0000-000000000000",
      "prompt": "Fill in values",
      "selector": []
    }
  ],
  "name": "",
  "secret": "regexp_replace(encode(extensions.gen_random_bytes(8), 'base64'::text), '[^a-zA-Z0-9]'::text, ''::text, 'g'::text)",
  "secret_anonymous": "regexp_replace(encode(extensions.gen_random_bytes(8), 'base64'::text), '[^a-zA-Z0-9]'::text, ''::text, 'g'::text)",
  "secret_editable": "regexp_replace(encode(extensions.gen_random_bytes(8), 'base64'::text), '[^a-zA-Z0-9]'::text, ''::text, 'g'::text)",
  "section_attachments": {},
  "status": "active",
  "values": {
    "name": "John Doe",
    "date_of_birth": "1995-01-01",
    "experiences": [
      {
        "interval": {
          "start": "2015-01-01",
          "end": "2018-01-01"
        },
        "company": "Example Inc.",
        "position": "Developer"
      }
    ]
  }
}

List candidates

Filters

idFilter<uuid>

Unique identifier

current_event_idFilter<uuid | null>
layout_idFilter<uuid | null>
layouts.id

Identifier of the related layout

member_idFilter<uuid | null>
members.id

Identifier of the member associated with this candidate (initially the creator)

organization_idFilter<uuid>
organizations.id

Identifier of the related organization

created_atFilter<timestamp with time zone>

Creation timestamp

updated_atFilter<timestamp with time zone>

Last modification timestamp

deleted_atFilter<timestamp with time zone | null>

Deletion timestamp

attachmentsFilter<Record<string, CandidateAttachment>>

Files attached to this candidate (CV, Vacancy, other)

avatarFilter<text | null>

The candidate's avatar image. Used for efficient display. Automatically filled when editing candidate from UI

export_filenameFilter<text>

Filename for exported PDF file (without .pdf). If left empty, layout.export_filename applies.

external_dataFilter<CandidateExternalData | null>

Data imported from an external source

ftsFilter<tsvector>
languageFilter<Language>

Language this candidate should be displayed in

messagesFilter<Array<CandidateMessage>>

List of messages exchanged with AI

nameFilter<text>

The candidate's name. Used for searching. Automatically filled when editing candidate from UI

secretFilter<text>

Secret string. Used to privately share a proposal for this candidate with personal information non-redacted

secret_anonymousFilter<text>

Secret string. Used to privately share a proposal for this candidate with personal information redacted

secret_editableFilter<text>

Secret string. Used to share the candidate for editing.

section_attachmentsFilter<Record<string, Array<string>>>

Links of attachments per attachment section

statusFilter<CandidateStatus>

Status of the candidate. Only active candidates can be shared

valuesFilter<JsonObject>

Values for the each of the variables defined in the layout the candidate uses

Responses

200

A list of candidates with the selected columns

206

Partial Content

GET /candidates
curl -X GET "https://api.cv-transformer.com/v1/candidates?select=*" \
  -H "Authorization: Bearer YOUR_API_KEY"

Delete candidates

Filters

idFilter<uuid>

Unique identifier

current_event_idFilter<uuid | null>
layout_idFilter<uuid | null>
layouts.id

Identifier of the related layout

member_idFilter<uuid | null>
members.id

Identifier of the member associated with this candidate (initially the creator)

organization_idFilter<uuid>
organizations.id

Identifier of the related organization

created_atFilter<timestamp with time zone>

Creation timestamp

updated_atFilter<timestamp with time zone>

Last modification timestamp

deleted_atFilter<timestamp with time zone | null>

Deletion timestamp

attachmentsFilter<Record<string, CandidateAttachment>>

Files attached to this candidate (CV, Vacancy, other)

avatarFilter<text | null>

The candidate's avatar image. Used for efficient display. Automatically filled when editing candidate from UI

export_filenameFilter<text>

Filename for exported PDF file (without .pdf). If left empty, layout.export_filename applies.

external_dataFilter<CandidateExternalData | null>

Data imported from an external source

ftsFilter<tsvector>
languageFilter<Language>

Language this candidate should be displayed in

messagesFilter<Array<CandidateMessage>>

List of messages exchanged with AI

nameFilter<text>

The candidate's name. Used for searching. Automatically filled when editing candidate from UI

secretFilter<text>

Secret string. Used to privately share a proposal for this candidate with personal information non-redacted

secret_anonymousFilter<text>

Secret string. Used to privately share a proposal for this candidate with personal information redacted

secret_editableFilter<text>

Secret string. Used to share the candidate for editing.

section_attachmentsFilter<Record<string, Array<string>>>

Links of attachments per attachment section

statusFilter<CandidateStatus>

Status of the candidate. Only active candidates can be shared

valuesFilter<JsonObject>

Values for the each of the variables defined in the layout the candidate uses

Responses

204

The deleted candidates with the selected columns

DELETE /candidates
curl -X DELETE "https://api.cv-transformer.com/v1/candidates" \
  -H "Authorization: Bearer YOUR_API_KEY"

Update candidates

Filters

idFilter<uuid>

Unique identifier

current_event_idFilter<uuid | null>
layout_idFilter<uuid | null>
layouts.id

Identifier of the related layout

member_idFilter<uuid | null>
members.id

Identifier of the member associated with this candidate (initially the creator)

organization_idFilter<uuid>
organizations.id

Identifier of the related organization

created_atFilter<timestamp with time zone>

Creation timestamp

updated_atFilter<timestamp with time zone>

Last modification timestamp

deleted_atFilter<timestamp with time zone | null>

Deletion timestamp

attachmentsFilter<Record<string, CandidateAttachment>>

Files attached to this candidate (CV, Vacancy, other)

avatarFilter<text | null>

The candidate's avatar image. Used for efficient display. Automatically filled when editing candidate from UI

export_filenameFilter<text>

Filename for exported PDF file (without .pdf). If left empty, layout.export_filename applies.

external_dataFilter<CandidateExternalData | null>

Data imported from an external source

ftsFilter<tsvector>
languageFilter<Language>

Language this candidate should be displayed in

messagesFilter<Array<CandidateMessage>>

List of messages exchanged with AI

nameFilter<text>

The candidate's name. Used for searching. Automatically filled when editing candidate from UI

secretFilter<text>

Secret string. Used to privately share a proposal for this candidate with personal information non-redacted

secret_anonymousFilter<text>

Secret string. Used to privately share a proposal for this candidate with personal information redacted

secret_editableFilter<text>

Secret string. Used to share the candidate for editing.

section_attachmentsFilter<Record<string, Array<string>>>

Links of attachments per attachment section

statusFilter<CandidateStatus>

Status of the candidate. Only active candidates can be shared

valuesFilter<JsonObject>

Values for the each of the variables defined in the layout the candidate uses

Body

Partial<Candidate>

Responses

204

The updated candidates with the selected columns

PATCH /candidates
curl -X PATCH "https://api.cv-transformer.com/v1/candidates" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{}'

Create candidate

Create a new candidate. Uses one credit. When no credits are available in the organization, the candidate is created with status="pending" instead.

Body

Partial<Candidate> & { member_external_id?: string }

Responses

200

The created candidate

POST /candidates
curl -X POST "https://api.cv-transformer.com/v1/candidates" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "attachments": {
      "CV": {
        "detected_source_language": null,
        "external_id": null,
        "label": "CV",
        "text": "",
        "type": "link",
        "url": "https://example.com/cv"
      }
    },
    "language": "nl",
    "layout_id": "00000000-0000-0000-0000-000000000000",
    "member_id": "00000000-0000-0000-0000-000000000000",
    "values": {
      "key": "value"
    }
  }'

Upload candidate attachment

Upload an attachment for a candidate.

Query parameters

locationstring

The type of attachment to upload. Defaults to cv.

Body

The file to attach. Supported file-types: .pdf, .doc, .docx, .jpeg, .png, .txt, .webp

Responses

200

The updated candidate

POST /candidates/[candidate_id]/attach
curl -X POST "https://api.cv-transformer.com/v1/candidates/[candidate_id]/attach?location=CV" \
  -H "Authorization: Bearer YOUR_API_KEY"

Fill / adjust candidate data

Fill or adjust a candidate's values.

Route parameters

candidate_idrequireduuid

The identifier of the candidate to fill.

Query parameters

promptstring

Custom prompt, e.g. "Expand introduction", "Sort skills by level". Organization's default prompt is used when left empty.

Responses

200

The updated candidate

POST /candidates/[candidate_id]/fill
curl -X POST "https://api.cv-transformer.com/v1/candidates/[candidate_id]/fill?style=" \
  -H "Authorization: Bearer YOUR_API_KEY"

Extract candidate data

Extract custom data from a candidate

Route parameters

candidate_idrequireduuid

The identifier of the candidate to extract data from.

Body

The JSONSchema of the data to extract.

Responses

200

The extracted data

POST /candidates/[candidate_id]/extract
curl -X POST "https://api.cv-transformer.com/v1/candidates/[candidate_id]/extract" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "type": "object",
    "properties": {
      "email": {
        "type": "string"
      },
      "first_name": {
        "type": "string"
      },
      "last_name": {
        "type": "string"
      }
    },
    "$schema": "http://json-schema.org/draft-07/schema#"
  }'

Credit mutations

Changes in credit per organization

Endpoints
GET/credit_mutations

The credit mutation object

Attributes

iduuid

Unique identifier

billing_account_iduuid | null
billing_accounts.id

Identifier of the related billing account

organization_iduuid | null
organizations.id

Identifier of the organization related to this mutation

created_attimestamp with time zone

Creation timestamp

deltainteger

Difference between next and previous credit

The credit mutation object

JSON

{
  "id": "00000000-0000-0000-0000-000000000000",
  "billing_account_id": "00000000-0000-0000-0000-000000000000",
  "organization_id": "00000000-0000-0000-0000-000000000000",
  "created_at": "2026-02-28T02:12:33.435Z",
  "delta": 0
}

List credit mutations

Filters

idFilter<uuid>

Unique identifier

billing_account_idFilter<uuid | null>
billing_accounts.id

Identifier of the related billing account

organization_idFilter<uuid | null>
organizations.id

Identifier of the organization related to this mutation

created_atFilter<timestamp with time zone>

Creation timestamp

deltaFilter<integer>

Difference between next and previous credit

Responses

200

A list of credit mutations with the selected columns

206

Partial Content

GET /credit_mutations
curl -X GET "https://api.cv-transformer.com/v1/credit_mutations?select=*" \
  -H "Authorization: Bearer YOUR_API_KEY"

Layouts

Layout definitions that can be filled in per candidate

Endpoints
GET/layoutsPOST/layoutsDELETE/layoutsPATCH/layouts

The layout object

Attributes

iduuid

Unique identifier

creator_iduuid | null
user_profiles.user_id

Identifier of the user that created this layout

organization_iduuid
organizations.id

Identifier of the related organization

parent_iduuid | null
layouts.id

Identifier of the layout this layout originates from

created_attimestamp with time zone

Creation timestamp

updated_attimestamp with time zone

Last modification timestamp

archived_attimestamp with time zone | null

Timestamp at which the layout is archived

assetsArray<LayoutAsset>

Reusable assets used in the layout

default_valuesPartial<Record<Language, JsonObject>>

Default values for each of the variables in the layout. When left empty, these values are auto-generated

descriptiontext

SEO description of the layout for in the library

export_filenametext

Filename for exported PDF files (without .pdf). Can contain {{variables}}

featuredboolean

Whether the layout is featured in the layout library

ftstsvector
languagesArray<Language>

Languages the layout is translated in. First entry indicates the default language

nametext

Title of this layout

page_heightinteger

Page height (in pixels)

page_widthinteger

Page width (in pixels)

secretuuid

Secret string. Required to view the layout when its visibility is "private"

sectionsArray<LayoutSection>

List of sections the layout consists of

share_instructionstext

Optional instructions shown in the share modal

slugtext

Unique identifier that allows easy lookup in the layout library

thumbnailtext | null

Thumbnail image for this layout. Automatically generated

tokensArray<LayoutDesignToken>

List of design tokens used in the layout

variablesArray<LayoutVariable>

List of variables used in the layout. Each candidate using this layout populates these variables

visibilityLayoutVisibility

Visibility of this layout. "public" means the layout is published to the layout library.

web_settingsLayoutWebSettings | null

Additional layout settings for web sharing

The layout object

JSON

{
  "id": "00000000-0000-0000-0000-000000000000",
  "creator_id": "00000000-0000-0000-0000-000000000000",
  "organization_id": "00000000-0000-0000-0000-000000000000",
  "parent_id": "00000000-0000-0000-0000-000000000000",
  "created_at": "2026-02-28T02:12:33.435Z",
  "updated_at": "2026-02-28T02:12:33.435Z",
  "archived_at": "2026-02-28T02:12:33.435Z",
  "assets": [
    {
      "family": "Roboto",
      "type": "font",
      "url": "https://example.com/roboto.ttf"
    },
    {
      "label": "Example",
      "type": "image",
      "url": "https://example.com/example.png"
    }
  ],
  "default_values": {
    "en": {
      "message": "Hello"
    },
    "nl": {
      "message": "Hallo"
    }
  },
  "description": "",
  "export_filename": "",
  "featured": false,
  "languages": [
    "en",
    "cs",
    "da-DK",
    "de",
    "en-GB",
    "es",
    "fr",
    "nb-NO",
    "nl",
    "yue",
    "zh"
  ],
  "name": "",
  "page_height": 1123,
  "page_width": 794,
  "secret": "00000000-0000-0000-0000-000000000000",
  "sections": [
    {
      "body": {
        "align": "left",
        "background": "#FFFFFF",
        "bold": false,
        "border": null,
        "borderRadius": "0",
        "color": "#000000",
        "columns": 1,
        "font": {
          "family": "Roboto",
          "letter_spacing": 0,
          "line_height": 1.5,
          "paragraph_spacing": 0.5,
          "size": 16
        },
        "grow": true,
        "id": "text",
        "italic": false,
        "margin": "0",
        "padding": 16,
        "listStyle": "disc",
        "split": false,
        "strikethrough": false,
        "textTransform": "none",
        "transform": "",
        "underline": false,
        "value": {
          "default": "Hello",
          "nl": "Hallo"
        },
        "visibility": true,
        "type": "text"
      },
      "footer": null,
      "header": null,
      "id": "section",
      "label": "Section",
      "type": "multi-page"
    }
  ],
  "share_instructions": "",
  "slug": "",
  "thumbnail": "",
  "tokens": [
    {
      "id": "primary-color",
      "name": "Primary color",
      "type": "color",
      "value": "#000000"
    },
    {
      "id": "font-size",
      "name": "Font size",
      "type": "length",
      "value": 16
    }
  ],
  "variables": [
    {
      "ai_instructions": "",
      "sensitive": false,
      "default": "",
      "key": "name",
      "max_length": null,
      "min_length": 0,
      "type": "inline-text"
    },
    {
      "ai_instructions": "",
      "sensitive": false,
      "default": "",
      "key": "description",
      "max_length": null,
      "min_length": 0,
      "type": "text-block"
    }
  ],
  "visibility": "public",
  "web_settings": {
    "color_accent": "#000000",
    "color_background": "#FFFFFF",
    "color_text": "#000000"
  }
}

List layouts

Filters

idFilter<uuid>

Unique identifier

creator_idFilter<uuid | null>
user_profiles.user_id

Identifier of the user that created this layout

organization_idFilter<uuid>
organizations.id

Identifier of the related organization

parent_idFilter<uuid | null>
layouts.id

Identifier of the layout this layout originates from

created_atFilter<timestamp with time zone>

Creation timestamp

updated_atFilter<timestamp with time zone>

Last modification timestamp

archived_atFilter<timestamp with time zone | null>

Timestamp at which the layout is archived

assetsFilter<Array<LayoutAsset>>

Reusable assets used in the layout

default_valuesFilter<Partial<Record<Language, JsonObject>>>

Default values for each of the variables in the layout. When left empty, these values are auto-generated

descriptionFilter<text>

SEO description of the layout for in the library

export_filenameFilter<text>

Filename for exported PDF files (without .pdf). Can contain {{variables}}

featuredFilter<boolean>

Whether the layout is featured in the layout library

ftsFilter<tsvector>
languagesFilter<Array<Language>>

Languages the layout is translated in. First entry indicates the default language

nameFilter<text>

Title of this layout

page_heightFilter<integer>

Page height (in pixels)

page_widthFilter<integer>

Page width (in pixels)

secretFilter<uuid>

Secret string. Required to view the layout when its visibility is "private"

sectionsFilter<Array<LayoutSection>>

List of sections the layout consists of

share_instructionsFilter<text>

Optional instructions shown in the share modal

slugFilter<text>

Unique identifier that allows easy lookup in the layout library

thumbnailFilter<text | null>

Thumbnail image for this layout. Automatically generated

tokensFilter<Array<LayoutDesignToken>>

List of design tokens used in the layout

variablesFilter<Array<LayoutVariable>>

List of variables used in the layout. Each candidate using this layout populates these variables

visibilityFilter<LayoutVisibility>

Visibility of this layout. "public" means the layout is published to the layout library.

web_settingsFilter<LayoutWebSettings | null>

Additional layout settings for web sharing

Responses

200

A list of layouts with the selected columns

206

Partial Content

GET /layouts
curl -X GET "https://api.cv-transformer.com/v1/layouts?select=*" \
  -H "Authorization: Bearer YOUR_API_KEY"

Create layouts

Body

Partial<Layout> | Array<Partial<Layout>>

Responses

201

The newly created layouts with the selected columns

POST /layouts
curl -X POST "https://api.cv-transformer.com/v1/layouts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '[]'

Delete layouts

Filters

idFilter<uuid>

Unique identifier

creator_idFilter<uuid | null>
user_profiles.user_id

Identifier of the user that created this layout

organization_idFilter<uuid>
organizations.id

Identifier of the related organization

parent_idFilter<uuid | null>
layouts.id

Identifier of the layout this layout originates from

created_atFilter<timestamp with time zone>

Creation timestamp

updated_atFilter<timestamp with time zone>

Last modification timestamp

archived_atFilter<timestamp with time zone | null>

Timestamp at which the layout is archived

assetsFilter<Array<LayoutAsset>>

Reusable assets used in the layout

default_valuesFilter<Partial<Record<Language, JsonObject>>>

Default values for each of the variables in the layout. When left empty, these values are auto-generated

descriptionFilter<text>

SEO description of the layout for in the library

export_filenameFilter<text>

Filename for exported PDF files (without .pdf). Can contain {{variables}}

featuredFilter<boolean>

Whether the layout is featured in the layout library

ftsFilter<tsvector>
languagesFilter<Array<Language>>

Languages the layout is translated in. First entry indicates the default language

nameFilter<text>

Title of this layout

page_heightFilter<integer>

Page height (in pixels)

page_widthFilter<integer>

Page width (in pixels)

secretFilter<uuid>

Secret string. Required to view the layout when its visibility is "private"

sectionsFilter<Array<LayoutSection>>

List of sections the layout consists of

share_instructionsFilter<text>

Optional instructions shown in the share modal

slugFilter<text>

Unique identifier that allows easy lookup in the layout library

thumbnailFilter<text | null>

Thumbnail image for this layout. Automatically generated

tokensFilter<Array<LayoutDesignToken>>

List of design tokens used in the layout

variablesFilter<Array<LayoutVariable>>

List of variables used in the layout. Each candidate using this layout populates these variables

visibilityFilter<LayoutVisibility>

Visibility of this layout. "public" means the layout is published to the layout library.

web_settingsFilter<LayoutWebSettings | null>

Additional layout settings for web sharing

Responses

204

The deleted layouts with the selected columns

DELETE /layouts
curl -X DELETE "https://api.cv-transformer.com/v1/layouts" \
  -H "Authorization: Bearer YOUR_API_KEY"

Update layouts

Filters

idFilter<uuid>

Unique identifier

creator_idFilter<uuid | null>
user_profiles.user_id

Identifier of the user that created this layout

organization_idFilter<uuid>
organizations.id

Identifier of the related organization

parent_idFilter<uuid | null>
layouts.id

Identifier of the layout this layout originates from

created_atFilter<timestamp with time zone>

Creation timestamp

updated_atFilter<timestamp with time zone>

Last modification timestamp

archived_atFilter<timestamp with time zone | null>

Timestamp at which the layout is archived

assetsFilter<Array<LayoutAsset>>

Reusable assets used in the layout

default_valuesFilter<Partial<Record<Language, JsonObject>>>

Default values for each of the variables in the layout. When left empty, these values are auto-generated

descriptionFilter<text>

SEO description of the layout for in the library

export_filenameFilter<text>

Filename for exported PDF files (without .pdf). Can contain {{variables}}

featuredFilter<boolean>

Whether the layout is featured in the layout library

ftsFilter<tsvector>
languagesFilter<Array<Language>>

Languages the layout is translated in. First entry indicates the default language

nameFilter<text>

Title of this layout

page_heightFilter<integer>

Page height (in pixels)

page_widthFilter<integer>

Page width (in pixels)

secretFilter<uuid>

Secret string. Required to view the layout when its visibility is "private"

sectionsFilter<Array<LayoutSection>>

List of sections the layout consists of

share_instructionsFilter<text>

Optional instructions shown in the share modal

slugFilter<text>

Unique identifier that allows easy lookup in the layout library

thumbnailFilter<text | null>

Thumbnail image for this layout. Automatically generated

tokensFilter<Array<LayoutDesignToken>>

List of design tokens used in the layout

variablesFilter<Array<LayoutVariable>>

List of variables used in the layout. Each candidate using this layout populates these variables

visibilityFilter<LayoutVisibility>

Visibility of this layout. "public" means the layout is published to the layout library.

web_settingsFilter<LayoutWebSettings | null>

Additional layout settings for web sharing

Body

Partial<Layout>

Responses

204

The updated layouts with the selected columns

PATCH /layouts
curl -X PATCH "https://api.cv-transformer.com/v1/layouts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{}'

Members

Links users to organizations via roles

Endpoints
GET/membersPATCH/membersPOST/membersDELETE/members

The member object

Attributes

iduuid

Unique identifier

external_idstring | number | null

The ID of this member in an external system. Used for matching imported candidates.

organization_iduuid
organizations.id

Identifier of the related organization

user_iduuid
user_profiles.user_id

Identifier of the related user

created_attimestamp with time zone

Creation timestamp

updated_attimestamp with time zone

Last modification timestamp

permissionsArray<Permission>

The permissions this member has

valuesRecord<string, MemberValue>

Values for each of the organization's member_variables, usable in layouts

The member object

JSON

{
  "id": "00000000-0000-0000-0000-000000000000",
  "external_id": "example-id",
  "organization_id": "00000000-0000-0000-0000-000000000000",
  "user_id": "00000000-0000-0000-0000-000000000000",
  "created_at": "2026-02-28T02:12:33.436Z",
  "updated_at": "2026-02-28T02:12:33.436Z",
  "permissions": [
    "billing",
    "edit_candidates",
    "edit_layouts",
    "settings",
    "team",
    "view_candidates"
  ],
  "values": {
    "first_name": "John",
    "last_name": "Doe"
  }
}

List members

Filters

idFilter<uuid>

Unique identifier

external_idFilter<string | number | null>

The ID of this member in an external system. Used for matching imported candidates.

organization_idFilter<uuid>
organizations.id

Identifier of the related organization

user_idFilter<uuid>
user_profiles.user_id

Identifier of the related user

created_atFilter<timestamp with time zone>

Creation timestamp

updated_atFilter<timestamp with time zone>

Last modification timestamp

permissionsFilter<Array<Permission>>

The permissions this member has

valuesFilter<Record<string, MemberValue>>

Values for each of the organization's member_variables, usable in layouts

Responses

200

A list of members with the selected columns

206

Partial Content

GET /members
curl -X GET "https://api.cv-transformer.com/v1/members?select=*" \
  -H "Authorization: Bearer YOUR_API_KEY"

Update members

Filters

idFilter<uuid>

Unique identifier

external_idFilter<string | number | null>

The ID of this member in an external system. Used for matching imported candidates.

organization_idFilter<uuid>
organizations.id

Identifier of the related organization

user_idFilter<uuid>
user_profiles.user_id

Identifier of the related user

created_atFilter<timestamp with time zone>

Creation timestamp

updated_atFilter<timestamp with time zone>

Last modification timestamp

permissionsFilter<Array<Permission>>

The permissions this member has

valuesFilter<Record<string, MemberValue>>

Values for each of the organization's member_variables, usable in layouts

Body

Partial<Member>

Responses

204

The updated members with the selected columns

PATCH /members
curl -X PATCH "https://api.cv-transformer.com/v1/members" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{}'

Invite member

Invite a member to your organization. The member will receive an email with a link to accept the invitation. The member will have the user role. To make a member admin or superuser use the dashboard.

Body

emailrequiredstring

The email address of the member to invite.

namestring

The name of the member to invite.

languageLanguage

The language of the member to invite.

Responses

201

The invited member with it's user profile

POST /members
curl -X POST "https://api.cv-transformer.com/v1/members" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "email": "johndoe@example.com",
    "name": "John Doe"
  }'
Example response

JSON

{
  "id": "00000000-0000-0000-0000-000000000000",
  "external_id": {},
  "organization_id": "00000000-0000-0000-0000-000000000000",
  "user_id": "00000000-0000-0000-0000-000000000000",
  "created_at": "2026-02-28T02:12:33.500Z",
  "updated_at": "2026-02-28T02:12:33.500Z",
  "permissions": [
    ""
  ],
  "values": {},
  "user_profile": {
    "user_id": "00000000-0000-0000-0000-000000000000",
    "created_at": "2026-02-28T02:12:33.500Z",
    "updated_at": "2026-02-28T02:12:33.500Z",
    "avatar": "",
    "email": "",
    "invited_at": "2026-02-28T02:12:33.500Z",
    "language": "nl",
    "last_login_at": "2026-02-28T02:12:33.500Z",
    "name": "",
    "phone": "",
    "source": ""
  }
}

Revoke member

Revoke a member from your organization. The member will no longer have access to your organization. Only works for members with the user role. To revoke an admin or superuser members use the dashboard.

Parameters

idrequireduuid

The identifier of the member to revoke.

Responses

200

The deleted member

DELETE /members
curl -X DELETE "https://api.cv-transformer.com/v1/members?id=00000000-0000-0000-0000-000000000000" \
  -H "Authorization: Bearer YOUR_API_KEY"

Organizations

All base information per organizations

Endpoints
GET/organizationsPATCH/organizations

The organization object

Attributes

iduuid

Unique identifier

billing_account_iduuid
billing_accounts.id

Identifier of the billing account this organization belongs to

default_layout_iduuid | null
layouts.id

Identifier of the layout that is used for new candidates by default

created_attimestamp with time zone

Creation timestamp

updated_attimestamp with time zone

Last modification timestamp

deleted_attimestamp with time zone | null

Deletion timestamp

active_ats_integrationIntegrationName | null

Currently active ATS integration

allow_inspectionboolean

Whether the CV-Transformer team is allowed to inspect the organization to debug errors

allow_word_outputboolean

Whether Word-output is enabled for the organization

allowed_senderstext[]

List of email addresses that are allowed to send CV's to the organizations inbox. Email addresses can be partial (e.g., @example.com)

atstext

The ATS this organization uses

avatartext | null

Avatar image representing the organization

default_prompttext

Default prompt used when filling in candidate data

delete_candidates_afterinteger | null

Time in days after which candidates are automatically deleted

detect_candidate_language_from_attachmentboolean

Automatically detect candidate language when first attachment is uploaded.

enable_beta_integrationsboolean
external_variablesArray<LayoutVariable>

Schema for data imported from external integration

ftstsvector
member_variablesArray<MemberVariable>

Metafields defined on each member. Usable in layouts

modeltext

LLM model to use

nametext

Name of the organization

proposal_byProposalAuthor

Author shown on weblink proposals

proposal_reactionsArray<ProposalReaction>

Allowed reactions on proposals

require_mfaboolean

Whether MFA is required for members to access this organization

slugtext

Unique string. Organization has a candidate email inbox at {{slug}}@candidates.cv-transformer.com

statusOrganizationStatus

Internal status for the organization

typeOrganizationType | null

Type of the organization

The organization object

JSON

{
  "id": "00000000-0000-0000-0000-000000000000",
  "billing_account_id": "00000000-0000-0000-0000-000000000000",
  "default_layout_id": "00000000-0000-0000-0000-000000000000",
  "created_at": "2026-02-28T02:12:33.437Z",
  "updated_at": "2026-02-28T02:12:33.437Z",
  "deleted_at": "2026-02-28T02:12:33.437Z",
  "active_ats_integration": "Greenhouse",
  "allow_inspection": true,
  "allow_word_output": false,
  "allowed_senders": [
    ""
  ],
  "ats": "",
  "avatar": "",
  "default_prompt": "",
  "delete_candidates_after": 90,
  "detect_candidate_language_from_attachment": false,
  "enable_beta_integrations": false,
  "external_variables": [
    {
      "ai_instructions": "",
      "sensitive": false,
      "default": "",
      "key": "name",
      "max_length": null,
      "min_length": 0,
      "type": "inline-text"
    },
    {
      "ai_instructions": "",
      "sensitive": false,
      "default": "",
      "key": "description",
      "max_length": null,
      "min_length": 0,
      "type": "text-block"
    }
  ],
  "member_variables": [
    {
      "ai_instructions": "",
      "sensitive": false,
      "default": "",
      "key": "name",
      "max_length": null,
      "min_length": 0,
      "type": "inline-text"
    },
    {
      "ai_instructions": "",
      "sensitive": false,
      "default": "",
      "key": "description",
      "max_length": null,
      "min_length": 0,
      "type": "text-block"
    }
  ],
  "model": "mistral/codestral",
  "name": "",
  "proposal_by": "contact",
  "proposal_reactions": [
    {
      "id": "invite",
      "body": "",
      "type": "email",
      "subject": ""
    },
    {
      "id": "comment",
      "body": "",
      "type": "email",
      "subject": ""
    },
    {
      "id": "reject",
      "body": "",
      "type": "email",
      "subject": ""
    }
  ],
  "require_mfa": false,
  "slug": "",
  "status": "active",
  "type": "regular"
}

List organizations

Filters

idFilter<uuid>

Unique identifier

billing_account_idFilter<uuid>
billing_accounts.id

Identifier of the billing account this organization belongs to

default_layout_idFilter<uuid | null>
layouts.id

Identifier of the layout that is used for new candidates by default

created_atFilter<timestamp with time zone>

Creation timestamp

updated_atFilter<timestamp with time zone>

Last modification timestamp

deleted_atFilter<timestamp with time zone | null>

Deletion timestamp

active_ats_integrationFilter<IntegrationName | null>

Currently active ATS integration

allow_inspectionFilter<boolean>

Whether the CV-Transformer team is allowed to inspect the organization to debug errors

allow_word_outputFilter<boolean>

Whether Word-output is enabled for the organization

allowed_sendersFilter<text[]>

List of email addresses that are allowed to send CV's to the organizations inbox. Email addresses can be partial (e.g., @example.com)

atsFilter<text>

The ATS this organization uses

avatarFilter<text | null>

Avatar image representing the organization

default_promptFilter<text>

Default prompt used when filling in candidate data

delete_candidates_afterFilter<integer | null>

Time in days after which candidates are automatically deleted

detect_candidate_language_from_attachmentFilter<boolean>

Automatically detect candidate language when first attachment is uploaded.

enable_beta_integrationsFilter<boolean>
external_variablesFilter<Array<LayoutVariable>>

Schema for data imported from external integration

ftsFilter<tsvector>
member_variablesFilter<Array<MemberVariable>>

Metafields defined on each member. Usable in layouts

modelFilter<text>

LLM model to use

nameFilter<text>

Name of the organization

proposal_byFilter<ProposalAuthor>

Author shown on weblink proposals

proposal_reactionsFilter<Array<ProposalReaction>>

Allowed reactions on proposals

require_mfaFilter<boolean>

Whether MFA is required for members to access this organization

slugFilter<text>

Unique string. Organization has a candidate email inbox at {{slug}}@candidates.cv-transformer.com

statusFilter<OrganizationStatus>

Internal status for the organization

typeFilter<OrganizationType | null>

Type of the organization

Responses

200

A list of organizations with the selected columns

206

Partial Content

GET /organizations
curl -X GET "https://api.cv-transformer.com/v1/organizations?select=*" \
  -H "Authorization: Bearer YOUR_API_KEY"

Update organizations

Filters

idFilter<uuid>

Unique identifier

billing_account_idFilter<uuid>
billing_accounts.id

Identifier of the billing account this organization belongs to

default_layout_idFilter<uuid | null>
layouts.id

Identifier of the layout that is used for new candidates by default

created_atFilter<timestamp with time zone>

Creation timestamp

updated_atFilter<timestamp with time zone>

Last modification timestamp

deleted_atFilter<timestamp with time zone | null>

Deletion timestamp

active_ats_integrationFilter<IntegrationName | null>

Currently active ATS integration

allow_inspectionFilter<boolean>

Whether the CV-Transformer team is allowed to inspect the organization to debug errors

allow_word_outputFilter<boolean>

Whether Word-output is enabled for the organization

allowed_sendersFilter<text[]>

List of email addresses that are allowed to send CV's to the organizations inbox. Email addresses can be partial (e.g., @example.com)

atsFilter<text>

The ATS this organization uses

avatarFilter<text | null>

Avatar image representing the organization

default_promptFilter<text>

Default prompt used when filling in candidate data

delete_candidates_afterFilter<integer | null>

Time in days after which candidates are automatically deleted

detect_candidate_language_from_attachmentFilter<boolean>

Automatically detect candidate language when first attachment is uploaded.

enable_beta_integrationsFilter<boolean>
external_variablesFilter<Array<LayoutVariable>>

Schema for data imported from external integration

ftsFilter<tsvector>
member_variablesFilter<Array<MemberVariable>>

Metafields defined on each member. Usable in layouts

modelFilter<text>

LLM model to use

nameFilter<text>

Name of the organization

proposal_byFilter<ProposalAuthor>

Author shown on weblink proposals

proposal_reactionsFilter<Array<ProposalReaction>>

Allowed reactions on proposals

require_mfaFilter<boolean>

Whether MFA is required for members to access this organization

slugFilter<text>

Unique string. Organization has a candidate email inbox at {{slug}}@candidates.cv-transformer.com

statusFilter<OrganizationStatus>

Internal status for the organization

typeFilter<OrganizationType | null>

Type of the organization

Body

Partial<Organization>

Responses

204

The updated organizations with the selected columns

PATCH /organizations
curl -X PATCH "https://api.cv-transformer.com/v1/organizations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{}'

User profiles

Endpoints
GET/user_profiles

The user profile object

Attributes

user_iduuid

Unique identifier

created_attimestamp with time zone

Creation timestamp

updated_attimestamp with time zone

Last modification timestamp

avatartext | null

Avatar image url

emailtext

Email address

ftstsvector
invited_attimestamp with time zone | null

Last invite timestamp

languageLanguage

User language

last_login_attimestamp with time zone | null

Last login timestamp

nametext

User name

phonetext

User phone number

sourcetext | null

User source

The user profile object

JSON

{
  "user_id": "00000000-0000-0000-0000-000000000000",
  "created_at": "2026-02-28T02:12:33.437Z",
  "updated_at": "2026-02-28T02:12:33.437Z",
  "avatar": "",
  "email": "",
  "invited_at": "2026-02-28T02:12:33.437Z",
  "language": "en",
  "last_login_at": "2026-02-28T02:12:33.437Z",
  "name": "",
  "phone": "",
  "source": ""
}

List user profiles

Filters

user_idFilter<uuid>

Unique identifier

created_atFilter<timestamp with time zone>

Creation timestamp

updated_atFilter<timestamp with time zone>

Last modification timestamp

avatarFilter<text | null>

Avatar image url

emailFilter<text>

Email address

ftsFilter<tsvector>
invited_atFilter<timestamp with time zone | null>

Last invite timestamp

languageFilter<Language>

User language

last_login_atFilter<timestamp with time zone | null>

Last login timestamp

nameFilter<text>

User name

phoneFilter<text>

User phone number

sourceFilter<text | null>

User source

Responses

200

A list of user profiles with the selected columns

206

Partial Content

GET /user_profiles
curl -X GET "https://api.cv-transformer.com/v1/user_profiles?select=*" \
  -H "Authorization: Bearer YOUR_API_KEY"

Webhook notifications

Tracks notifications sent via webhooks for various events

Endpoints
GET/webhook_notifications

The webhook notification object

Attributes

iduuid

Unique identifier

webhook_iduuid
webhooks.id

Identifier of the webhook this notification is related to

created_attimestamp with time zone

Creation timestamp

updated_attimestamp with time zone

Last modification timestamp

created_ondate

Date on which the notification was created

event_typeWebhookEvent

Event this notification is for

payloadjsonb

JSON payload that is sent along with this notification

responsetext | null

Stored response

statusWebhookNotificationStatus

Notification status

triesinteger

Amount of times this webhook notification has been tried to be delivered

The webhook notification object

JSON

{
  "id": "00000000-0000-0000-0000-000000000000",
  "webhook_id": "00000000-0000-0000-0000-000000000000",
  "created_at": "2026-02-28T02:12:33.438Z",
  "updated_at": "2026-02-28T02:12:33.438Z",
  "created_on": null,
  "event_type": "candidates.created",
  "payload": {},
  "response": "",
  "status": "sent",
  "tries": 0
}

List webhook notifications

Filters

idFilter<uuid>

Unique identifier

webhook_idFilter<uuid>
webhooks.id

Identifier of the webhook this notification is related to

created_atFilter<timestamp with time zone>

Creation timestamp

updated_atFilter<timestamp with time zone>

Last modification timestamp

created_onFilter<date>

Date on which the notification was created

event_typeFilter<WebhookEvent>

Event this notification is for

payloadFilter<jsonb>

JSON payload that is sent along with this notification

responseFilter<text | null>

Stored response

statusFilter<WebhookNotificationStatus>

Notification status

triesFilter<integer>

Amount of times this webhook notification has been tried to be delivered

Responses

200

A list of webhook notifications with the selected columns

206

Partial Content

GET /webhook_notifications
curl -X GET "https://api.cv-transformer.com/v1/webhook_notifications?select=*" \
  -H "Authorization: Bearer YOUR_API_KEY"

Webhooks

Webhook event destinations

Endpoints
GET/webhooksPOST/webhooksDELETE/webhooksPATCH/webhooks

The webhook object

Attributes

iduuid

Unique identifier

organization_iduuid
organizations.id

Identifier of the organization this webhook is defined in

created_attimestamp with time zone

Creation timestamp

updated_attimestamp with time zone

Last modification timestamp

descriptiontext

An optional description of the webhook

endpointtext

URL to which notifications should be sent

eventsArray<WebhookEvent>

Events to which the webhook is subscribed

signing_secrettext

String used to sign each notification send to the webhook. Used to verify the validity of the webhook notifications

sourcetext

From where the webhook is registered. Can be from the admin, via the API, or via an external tool such as Zapier

The webhook object

JSON

{
  "id": "00000000-0000-0000-0000-000000000000",
  "organization_id": "00000000-0000-0000-0000-000000000000",
  "created_at": "2026-02-28T02:12:33.439Z",
  "updated_at": "2026-02-28T02:12:33.439Z",
  "description": "",
  "endpoint": "",
  "events": [
    "candidates.created",
    "members.updated"
  ],
  "signing_secret": "md5((random())::text)",
  "source": ""
}

List webhooks

Filters

idFilter<uuid>

Unique identifier

organization_idFilter<uuid>
organizations.id

Identifier of the organization this webhook is defined in

created_atFilter<timestamp with time zone>

Creation timestamp

updated_atFilter<timestamp with time zone>

Last modification timestamp

descriptionFilter<text>

An optional description of the webhook

endpointFilter<text>

URL to which notifications should be sent

eventsFilter<Array<WebhookEvent>>

Events to which the webhook is subscribed

signing_secretFilter<text>

String used to sign each notification send to the webhook. Used to verify the validity of the webhook notifications

sourceFilter<text>

From where the webhook is registered. Can be from the admin, via the API, or via an external tool such as Zapier

Responses

200

A list of webhooks with the selected columns

206

Partial Content

GET /webhooks
curl -X GET "https://api.cv-transformer.com/v1/webhooks?select=*" \
  -H "Authorization: Bearer YOUR_API_KEY"

Create webhooks

Body

Partial<Webhook> | Array<Partial<Webhook>>

Responses

201

The newly created webhooks with the selected columns

POST /webhooks
curl -X POST "https://api.cv-transformer.com/v1/webhooks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '[]'

Delete webhooks

Filters

idFilter<uuid>

Unique identifier

organization_idFilter<uuid>
organizations.id

Identifier of the organization this webhook is defined in

created_atFilter<timestamp with time zone>

Creation timestamp

updated_atFilter<timestamp with time zone>

Last modification timestamp

descriptionFilter<text>

An optional description of the webhook

endpointFilter<text>

URL to which notifications should be sent

eventsFilter<Array<WebhookEvent>>

Events to which the webhook is subscribed

signing_secretFilter<text>

String used to sign each notification send to the webhook. Used to verify the validity of the webhook notifications

sourceFilter<text>

From where the webhook is registered. Can be from the admin, via the API, or via an external tool such as Zapier

Responses

204

The deleted webhooks with the selected columns

DELETE /webhooks
curl -X DELETE "https://api.cv-transformer.com/v1/webhooks" \
  -H "Authorization: Bearer YOUR_API_KEY"

Update webhooks

Filters

idFilter<uuid>

Unique identifier

organization_idFilter<uuid>
organizations.id

Identifier of the organization this webhook is defined in

created_atFilter<timestamp with time zone>

Creation timestamp

updated_atFilter<timestamp with time zone>

Last modification timestamp

descriptionFilter<text>

An optional description of the webhook

endpointFilter<text>

URL to which notifications should be sent

eventsFilter<Array<WebhookEvent>>

Events to which the webhook is subscribed

signing_secretFilter<text>

String used to sign each notification send to the webhook. Used to verify the validity of the webhook notifications

sourceFilter<text>

From where the webhook is registered. Can be from the admin, via the API, or via an external tool such as Zapier

Body

Partial<Webhook>

Responses

204

The updated webhooks with the selected columns

PATCH /webhooks
curl -X PATCH "https://api.cv-transformer.com/v1/webhooks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{}'