COcopper
Companies

Search companies

Search companies. Response uses a pagination envelope (page_number,total,data) so ChatGPT can read pagination info; the X-PW-TOTAL header still exists. Paginate with page_number/page_size (max 200) until received records equal total. Limited to 100K results.

post/companies/search

Request

  • Base URL
    https://api.copper.com/developer_api/v1
  • Auth
    HTTP bearer

Query parameters

custom_field_computed_valuesboolean

When true, returns computed custom field values (human-readable labels) in addition to option IDs for Dropdown and Multi-select fields. The response will include a 'computed_value' field alongside the 'value' field in custom_fields array.

Request body

idsinteger[]

An array of Company IDs to retrieve

email_domainstring

Filter by email domain (unique key for companies)

email_domainsstring[]

An array of email domains to filter by

phone_numberstring

Filter by phone number

citystring

Filter by city in address

statestring

Filter by state in address

postal_codestring

Filter by postal code in address

countrystring

Filter by country in address (two-character country code)

primary_contact_idsinteger[]

An array of person IDs who are the primary contacts for these companies.

tagsstring[]

An array of tags to filter by

assignee_idsinteger[]

An array of assignee IDs to filter by (the user IDs who own these companies). Use -2 for no assignee.

contact_type_idsinteger[]

An array of contact type IDs to filter by. See List Contact Types.

socialsstring[]

An array of social profile URLs to filter by

followed1 | 2

Filter by followed status. Use 1 for followed companies, 2 for not followed.

ageinteger

Maximum age in seconds of the company record

minimum_interaction_countinteger

Filter by minimum number of interactions

maximum_interaction_countinteger

Filter by maximum number of interactions

minimum_interaction_dateinteger

Unix timestamp for the earliest date of the last interaction

maximum_interaction_dateinteger

Unix timestamp for the latest date of the last interaction

minimum_created_dateinteger

Unix timestamp for the minimum creation date

maximum_created_dateinteger

Unix timestamp for the maximum creation date

minimum_modified_dateinteger

Unix timestamp for the minimum modification date

maximum_modified_dateinteger

Unix timestamp for the maximum modification date

sort_by'name' | 'phone' | 'contact' | 'contact_first_name' | 'contact_last_name' | 'date_modified' | 'date_created' | 'email_domain' | 'city' | 'state' | 'country' | 'zip' | 'assignee' | 'contact_group' | 'last_interaction' | 'interaction_count' | 'primary_website' | 'socials'

The field on which to sort the results

sort_direction'asc' | 'desc'

The direction in which to sort the results

page_numberinteger

The page number (starting with 1) that you would like to view

page_sizeinteger

The number of entries included in a page of results

Example request

{
  "name": {
    "value": "Happy Cat",
    "special_value": [
      {
        "type": "partial"
      }
    ]
  },
  "fields": [
    "id",
    "name",
    "email_domain",
    "assignee_id",
    "interaction_count"
  ]
}

Response

Companies retrieved successfully

page_numberinteger required

Current page number (defaults to 1 when not provided in the request).

totalinteger required

Total number of records that match the request filters (equivalent to the X-PW-TOTAL header).

Example response

{
  "page_number": 1,
  "total": 775,
  "data": []
}

Changes

No recorded changes to this operation across all 1 revision of this API.