List Contacts

URL Expired

The URL for this request expired after 30 days.

Query Parameters

• listIds
  array of strings
  length ≤ 20
  Filter to contacts in these lists. Pass as repeated query params (e.g. ?listIds=abc&listIds=def). If omitted, contacts are returned across all lists and folders the caller has access to.

• currentCompany
  string
  Filter to contacts whose CURRENT employer matches this company name (case-insensitive, partial match). Matches headlineCompany and current jobs (jobs with no ended_on); does not match past employers or note mentions.

• titles
  array of strings
  length ≤ 10
  Filter to contacts whose current title matches ANY of these values (case-insensitive, partial match). Pass as repeated query params (e.g. ?titles=CEO&titles=CFO).

• tagsAny
  array of strings
  length ≤ 10
  Filter to contacts where ANY of these tags/industries appear (case-insensitive, matches tags, industry, or headline). Pass as repeated query params (e.g. ?tagsAny=technology&tagsAny=software).

• locationCity
  string
  Filter to contacts whose structured work-location or home-location city matches this value (case-insensitive, partial match).

• locationCountry
  string
  Filter to contacts whose structured work-location or home-location country matches this value (case-insensitive, partial match).

• queryTerms
  array of strings
  length ≤ 5
  OR-logic alternative to search: contacts matching ANY term are returned. Pass as repeated query params (e.g. ?queryTerms=investment+banking&queryTerms=M%26A). When set, search is ignored.

• folderIds
  array of strings
  length ≤ 20
  Filter to contacts belonging to any of these folder IDs. Pass as repeated query params (e.g. ?folderIds=abc&folderIds=def). Can be combined with listIds. If omitted, contacts are returned across all lists and folders the caller has access to.

• limit
  integer
  1 to 100
  Defaults to 100
  Maximum number of results to return per request.

• offset
  integer
  0 to 1000000
  Defaults to 0
  Number of results to skip for pagination.

• search
  string
  Defaults to null
  Search query string to filter results.

Response Codes

• 200
• 400 Invalid request parameters
• 401 Invalid or missing API key
• 404 Resource not found
• 500 Internal server error

Sample CURL Request

curl --request GET \
     --url https://crm-public-api.app.carta.com/v1/contacts \
     --header 'accept: application/json'

Try It!

Click Try It! to start a request and see the response here! Or choose an example:

Response Formats

• application/json
• 200
• 400
• 401
• 404
• 500