Companies

A Company represents an organization a client, prospect, or partner. Companies can be linked to People, Opportunities, Notes, and Tasks.

Source:apiDocs/company.md

View on GitHub ↗All docs ↗

Method	Path	Description
POST	`/rest/companies`	Create a new company
GET	`/rest/companies/{id}`	Get a company by ID
GET	`/rest/companies`	List companies
PATCH	`/rest/companies/{id}`	Update a company
DELETE	`/rest/companies/{id}`	Delete a company
POST	`/graphql`	Search companies by name

POST/rest/companies

Create a new company. Only name is required.

💡 ARR is stored in micros. $500,000 = 500000000000 (multiply by 1,000,000).

Body

namerequiredstring

Company name

domainName.primaryLinkUrlstring

Website URL

linkedinLink.primaryLinkUrlstring

LinkedIn page URL

industrystring

Business sector

employeesnumber

Total employee count (min: 1)

idealCustomerProfileboolean

Whether this company matches ICP criteria

workPolicystring[]

ON_SITE, HYBRID, and/or REMOTE_WORK

annualRecurringRevenue.amountMicrosnumber

ARR in micros (× 1,000,000)

annualRecurringRevenue.currencyCodestring

e.g. "USD"

addressobject

addressStreet1, addressCity, addressState, addressCountry, etc.

accountOwnerIdUUID

Workspace member who owns this record

Requestcurl

curl -X POST "https://app.usedalil.ai/rest/companies" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Corp",
    "domainName": {
      "primaryLinkUrl": "https://acmecorp.com",
      "primaryLinkLabel": "Website",
      "secondaryLinks": []
    },
    "linkedinLink": {
      "primaryLinkUrl": "https://linkedin.com/company/acme-corp",
      "primaryLinkLabel": "LinkedIn",
      "secondaryLinks": []
    },
    "industry": "Technology",
    "employees": 150,
    "idealCustomerProfile": true,
    "workPolicy": ["HYBRID"],
    "annualRecurringRevenue": {
      "amountMicros": 500000000000,
      "currencyCode": "USD"
    }
  }'

Response · 200

{
  "data": {
    "createCompany": {
      "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "name": "Acme Corp",
      "industry": "Technology",
      "employees": 150,
      "createdAt": "2026-04-29T10:00:00.000Z"
    }
  }
}

GET/rest/companies/{id}

Get a single company by UUID. Use depth=1 to include people, opportunities, and the account owner.

Parameters

idrequiredUUID

Company ID

depthnumber

0 = record · 1 = + relations. Avoid depth=2 (500KB+ responses).

Requestcurl

curl -G "https://app.usedalil.ai/rest/companies/b2c3d4e5-..." \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "depth=1"

GET/rest/companies

List companies with optional filtering and sorting. Uses cursor-based pagination.

Parameters

limitnumber

Records per page (default 60)

starting_afterUUID

Cursor pass last record's ID

order_bystring

e.g. name[AscNullsLast]

filterstring

Filter expression URL-encode

depthnumber

Related objects depth

Requestcurl

# Companies with 50+ employees, sorted A–Z
curl -G "https://app.usedalil.ai/rest/companies" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "filter=employees[gte]:50" \
  --data-urlencode "order_by=name[AscNullsLast]"

# ICP-matching companies
curl -G "https://app.usedalil.ai/rest/companies" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "filter=idealCustomerProfile[eq]:true"

PATCH/rest/companies/{id}

Update fields on a company. Send only the fields you want to change.

Parameters

idrequiredUUID

Company ID

Requestcurl

curl -X PATCH "https://app.usedalil.ai/rest/companies/b2c3d4e5-..." \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "employees": 200,
    "tagline": "Innovation at its finest"
  }'

DELETE/rest/companies/{id}

Permanently delete a company. This cannot be undone.

Parameters

idrequiredUUID

Company ID

Requestcurl

curl -X DELETE "https://app.usedalil.ai/rest/companies/b2c3d4e5-..." \
  -H "Authorization: Bearer YOUR_API_KEY"

POST/graphql

Search companies by name. Returns IDs only follow up with a REST list request.

💡 Always follow up with GET /rest/companies?filter=id[in]:[id1,id2] to get full records.

Requestcurl

# Step 1 GraphQL name search
curl -X POST "https://app.usedalil.ai/graphql" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "query Search($searchInput: String!) { search(searchInput: $searchInput, includedObjectNameSingulars: [\"company\"], limit: 5) { edges { node { recordId label } } } }",
    "variables": { "searchInput": "Acme" }
  }'

# Step 2 fetch full records
curl -G "https://app.usedalil.ai/rest/companies" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "filter=id[in]:[recordId1,recordId2]"

Filter Examples

filter=industry[ilike]:technology
filter=employees[gte]:50
filter=idealCustomerProfile[eq]:true
filter=annualRecurringRevenue.amountMicros[gt]:100000000000
filter=accountOwnerId[is]:NULL
filter=workPolicy[in]:[REMOTE_WORK]
filter=domainName.primaryLinkUrl[ilike]:acmecorp.com