CompaniesList companies

List companies

Requires companies:read. Returns a cursor page. Query predicates are AND-combined; in matches any listed value. At most 10 predicates, including 3 custom predicates. Dynamic filters use filter[customFields.KEY][operator]; replace KEY with an active definition key. in/hasAny use comma-separated strings (up to 50 values). These dynamic names cannot be enumerated as fixed OpenAPI parameters. See the filtering and custom-fields guides. Fields omitted from list output may still be filtered using supported operators.

curl -X GET "https://app.inrepli.com/v1/companies?limit=50&cursor=example_string&count=null&q=example_string&sort=-createdAt&filter[id]=example_string&filter[id][in]=example_string&filter[id][isNull]=example_string&filter[ownerId]=example_string&filter[ownerId][in]=example_string&filter[ownerId][isNull]=example_string&filter[createdAt]=example_string&filter[createdAt][gt]=example_string&filter[createdAt][gte]=example_string&filter[createdAt][lt]=example_string&filter[createdAt][lte]=example_string&filter[createdAt][isNull]=example_string&filter[updatedAt]=example_string&filter[updatedAt][gt]=example_string&filter[updatedAt][gte]=example_string&filter[updatedAt][lt]=example_string&filter[updatedAt][lte]=example_string&filter[updatedAt][isNull]=example_string&filter[lastInteractionAt]=example_string&filter[lastInteractionAt][gt]=example_string&filter[lastInteractionAt][gte]=example_string&filter[lastInteractionAt][lt]=example_string&filter[lastInteractionAt][lte]=example_string&filter[lastInteractionAt][isNull]=example_string&filter[enrichmentStatus]=example_string&filter[enrichmentStatus][in]=example_string&filter[enrichmentStatus][isNull]=example_string&filter[domain]=example_string&filter[domain][in]=example_string&filter[industry]=example_string&filter[industry][in]=example_string&filter[industry][isNull]=example_string&filter[subIndustry]=example_string&filter[subIndustry][in]=example_string&filter[subIndustry][isNull]=example_string&filter[hqCountry]=USA&filter[hqCountry][in]=USA&filter[hqCountry][isNull]=USA&filter[employeeCount]=example_string&filter[employeeCount][gt]=example_string&filter[employeeCount][gte]=example_string&filter[employeeCount][lt]=example_string&filter[employeeCount][lte]=example_string&filter[employeeCount][isNull]=example_string&filter[yearFounded]=example_string&filter[yearFounded][gt]=example_string&filter[yearFounded][gte]=example_string&filter[yearFounded][lt]=example_string&filter[yearFounded][lte]=example_string&filter[yearFounded][isNull]=example_string&filter[customerFitScore]=example_string&filter[customerFitScore][gt]=example_string&filter[customerFitScore][gte]=example_string&filter[customerFitScore][lt]=example_string&filter[customerFitScore][lte]=example_string&filter[customerFitScore][isNull]=example_string&include=example_string" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN"
{
  "data": [
    {
      "id": "example-id-4",
      "name": "Example company",
      "registeredName": null,
      "industry": null,
      "subIndustry": null,
      "employeeCount": 80,
      "revenue": null,
      "hqCountry": null,
      "yearFounded": null,
      "ownerId": null,
      "logo": null,
      "enrichmentAt": null,
      "enrichmentStatus": null,
      "lastMessageSentAt": null,
      "lastMessageReceivedAt": null,
      "lastInteractionAt": null,
      "createdAt": "2026-09-09T06:34:58.415Z",
      "updatedAt": "2026-09-09T06:34:58.415Z",
      "customerFitScore": null,
      "etag": ""2026-09-09T06:34:58.415Z"",
      "websiteUrl": "https://example.com",
      "customFields": {}
    }
  ],
  "nextCursor": null,
  "total": 1
}
GET
/companies
GET
Base URLstring

Target server for requests. Edit to use your own host.

Bearer Token
Bearer Tokenstring
Required

Tenant API key beginning with inr_v1_.

Tenant API key beginning with inr_v1_.
query
limitinteger

Page size.

Min: 1 • Max: 100
query
cursorstring

Opaque nextCursor from the preceding page. Preserve filters, q, sort, count and include. Bound to tenant and key scopes; not a snapshot.

query
countstring

Optional complete filtered count.

Options: exact
query
qstring

Optional case-insensitive substring search of basic identity text, not custom fields or notes. Whitespace is trimmed.

Min length: 2 • Max length: 100
query
sortstring

Comma-separated fields: createdAt, updatedAt, name, lastInteractionAt, employeeCount, customerFitScore. Prefix - for descending. Default -createdAt; at most two distinct fields. Server appends id as a tie-breaker; nullable values sort last.

query
filter[id]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

query
filter[id][in]string

Comma-separated values (1–50), sent once as a string. No repeated keys or JSON arrays.

query
filter[id][isNull]string

Literal true for missing/null, false for present.

query
filter[ownerId]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

query
filter[ownerId][in]string

Comma-separated values (1–50), sent once as a string. No repeated keys or JSON arrays.

query
filter[ownerId][isNull]string

Literal true for missing/null, false for present.

query
filter[createdAt]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

query
filter[createdAt][gt]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

query
filter[createdAt][gte]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

query
filter[createdAt][lt]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

query
filter[createdAt][lte]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

query
filter[createdAt][isNull]string

Literal true for missing/null, false for present.

query
filter[updatedAt]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

query
filter[updatedAt][gt]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

query
filter[updatedAt][gte]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

query
filter[updatedAt][lt]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

query
filter[updatedAt][lte]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

query
filter[updatedAt][isNull]string

Literal true for missing/null, false for present.

query
filter[lastInteractionAt]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

query
filter[lastInteractionAt][gt]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

query
filter[lastInteractionAt][gte]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

query
filter[lastInteractionAt][lt]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

query
filter[lastInteractionAt][lte]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

query
filter[lastInteractionAt][isNull]string

Literal true for missing/null, false for present.

query
filter[enrichmentStatus]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

query
filter[enrichmentStatus][in]string

Comma-separated values (1–50), sent once as a string. No repeated keys or JSON arrays.

query
filter[enrichmentStatus][isNull]string

Literal true for missing/null, false for present.

query
filter[domain]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

query
filter[domain][in]string

Comma-separated values (1–50), sent once as a string. No repeated keys or JSON arrays.

query
filter[industry]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

query
filter[industry][in]string

Comma-separated values (1–50), sent once as a string. No repeated keys or JSON arrays.

query
filter[industry][isNull]string

Literal true for missing/null, false for present.

query
filter[subIndustry]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

query
filter[subIndustry][in]string

Comma-separated values (1–50), sent once as a string. No repeated keys or JSON arrays.

query
filter[subIndustry][isNull]string

Literal true for missing/null, false for present.

query
filter[hqCountry]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

query
filter[hqCountry][in]string

Comma-separated values (1–50), sent once as a string. No repeated keys or JSON arrays.

query
filter[hqCountry][isNull]string

Literal true for missing/null, false for present.

query
filter[employeeCount]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

query
filter[employeeCount][gt]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

query
filter[employeeCount][gte]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

query
filter[employeeCount][lt]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

query
filter[employeeCount][lte]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

query
filter[employeeCount][isNull]string

Literal true for missing/null, false for present.

query
filter[yearFounded]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

query
filter[yearFounded][gt]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

query
filter[yearFounded][gte]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

query
filter[yearFounded][lt]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

query
filter[yearFounded][lte]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

query
filter[yearFounded][isNull]string

Literal true for missing/null, false for present.

query
filter[customerFitScore]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

query
filter[customerFitScore][gt]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

query
filter[customerFitScore][gte]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

query
filter[customerFitScore][lt]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

query
filter[customerFitScore][lte]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

query
filter[customerFitScore][isNull]string

Literal true for missing/null, false for present.

query
includestring

Optional owner/contactSummary require corresponding resource read access. fit/enrichment remain accepted; lists return fit score and enrichment status but never fit reason or notes.

Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token. Tenant API key beginning with inr_v1_.

Query Parameters

limitinteger

Page size.

cursorstring

Opaque nextCursor from the preceding page. Preserve filters, q, sort, count and include. Bound to tenant and key scopes; not a snapshot.

countstring

Optional complete filtered count.

Allowed values:exact
qstring

Optional case-insensitive substring search of basic identity text, not custom fields or notes. Whitespace is trimmed.

sortstring

Comma-separated fields: createdAt, updatedAt, name, lastInteractionAt, employeeCount, customerFitScore. Prefix - for descending. Default -createdAt; at most two distinct fields. Server appends id as a tie-breaker; nullable values sort last.

filter[id]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

filter[id][in]string

Comma-separated values (1–50), sent once as a string. No repeated keys or JSON arrays.

filter[id][isNull]string

Literal true for missing/null, false for present.

filter[ownerId]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

filter[ownerId][in]string

Comma-separated values (1–50), sent once as a string. No repeated keys or JSON arrays.

filter[ownerId][isNull]string

Literal true for missing/null, false for present.

filter[createdAt]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

filter[createdAt][gt]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

filter[createdAt][gte]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

filter[createdAt][lt]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

filter[createdAt][lte]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

filter[createdAt][isNull]string

Literal true for missing/null, false for present.

filter[updatedAt]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

filter[updatedAt][gt]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

filter[updatedAt][gte]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

filter[updatedAt][lt]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

filter[updatedAt][lte]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

filter[updatedAt][isNull]string

Literal true for missing/null, false for present.

filter[lastInteractionAt]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

filter[lastInteractionAt][gt]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

filter[lastInteractionAt][gte]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

filter[lastInteractionAt][lt]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

filter[lastInteractionAt][lte]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

filter[lastInteractionAt][isNull]string

Literal true for missing/null, false for present.

filter[enrichmentStatus]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

filter[enrichmentStatus][in]string

Comma-separated values (1–50), sent once as a string. No repeated keys or JSON arrays.

filter[enrichmentStatus][isNull]string

Literal true for missing/null, false for present.

filter[domain]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

filter[domain][in]string

Comma-separated values (1–50), sent once as a string. No repeated keys or JSON arrays.

filter[industry]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

filter[industry][in]string

Comma-separated values (1–50), sent once as a string. No repeated keys or JSON arrays.

filter[industry][isNull]string

Literal true for missing/null, false for present.

filter[subIndustry]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

filter[subIndustry][in]string

Comma-separated values (1–50), sent once as a string. No repeated keys or JSON arrays.

filter[subIndustry][isNull]string

Literal true for missing/null, false for present.

filter[hqCountry]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

filter[hqCountry][in]string

Comma-separated values (1–50), sent once as a string. No repeated keys or JSON arrays.

filter[hqCountry][isNull]string

Literal true for missing/null, false for present.

filter[employeeCount]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

filter[employeeCount][gt]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

filter[employeeCount][gte]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

filter[employeeCount][lt]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

filter[employeeCount][lte]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

filter[employeeCount][isNull]string

Literal true for missing/null, false for present.

filter[yearFounded]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

filter[yearFounded][gt]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

filter[yearFounded][gte]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

filter[yearFounded][lt]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

filter[yearFounded][lte]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

filter[yearFounded][isNull]string

Literal true for missing/null, false for present.

filter[customerFitScore]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

filter[customerFitScore][gt]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

filter[customerFitScore][gte]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

filter[customerFitScore][lt]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

filter[customerFitScore][lte]string

Send once as a string. filter[field] is shorthand for filter[field][eq]. Dates must be valid calendar dates and timestamps must include a timezone.

filter[customerFitScore][isNull]string

Literal true for missing/null, false for present.

includestring

Optional owner/contactSummary require corresponding resource read access. fit/enrichment remain accepted; lists return fit score and enrichment status but never fit reason or notes.

Responses

dataarray
Required
nextCursorstring,null
Required
totalinteger