Skip to main content
POST
Full records for a list of companies

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
ids
string[]
required

DataDingo company ids (the id on every card). At most 1000. A repeated id is delivered and charged once; an id that matches no company is free and listed in not_found.

Required array length: 1 - 1000 elements
Required string length: 1 - 100
dry_run
boolean

true = return the quote only (how many are new, already yours or not found, the credits needed and available, and the fields you would get) and charge nothing.

Response

Default Response

Full company records for the requested ids

companies
object[]
required

One full card per found id, in the order the ids were first given.

not_found
string[]
required

The requested ids that match no company (free), in request order, each once.

charged
integer
required

Credits this call spent: the found companies your account did not already have.

already_yours
integer
required

Found companies your account already had (free). 0 when no credits are metered.