| Time | Status | User Agent |  |
| :-- | :-- | :-- | :-- |
| Make a request to see history. |

#### 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

```bash
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`