Reveal full companies (1 credit per company)

Return the full data of the companies with the given ids (from POST /api/v1/directory/companies/search). Each revealed company costs 1 credit the first time; revealing it again is free. If the credit balance cannot cover all requested ids, only the first affordable companies are revealed and charged, and the rest are listed in not_revealed_ids. Needs the contacts:write scope.

posthttps://app.replysparrow.com/api/v1/directory/companies/reveal

Authorizations

Authorizationstringheaderrequired

Your API key from Settings → API, sent as Bearer <token>.

Body

application/json

idsstring[]required

Company ids from Search companies

Response

application/json

Full companies and credit usage summary

companiesobject[]required

Revealed companies

requestednumberrequired

Number of distinct ids requested

revealednumberrequired

Number of records actually returned

credits_usednumberrequired

Credits spent by this call

not_found_idsstring[]

Ids that are not results of one of your searches

not_revealed_idsstring[]

Ids skipped because the credit balance ran out

Ctrl+I

Reveal full companies (1 credit per company)

curl --request POST \  --url https://app.replysparrow.com/api/v1/directory/companies/reveal \  --header 'Authorization: Bearer <token>' \  --header 'Content-Type: application/json' \  --data '{  "ids": [    "dc_9b1e2f3a4c5d6e7f8a9b0c1d"  ]}'

{  "companies": [    {      "id": "string",      "name": "string",      "industry": "string",      "company_size": "string",      "headquarters": "string",      "website": "string",      "domain": "string",      "linkedin_url": "string",      "description": "string",      "employee_count": 0    }  ],  "requested": 0,  "revealed": 0,  "credits_used": 0,  "not_found_ids": [    "string"  ],  "not_revealed_ids": [    "string"  ]}