Investor companies
One investor company’s profile, purchases and sales.
Read an investor company’s profile
Cost: $0.50 per company · desks only
Returns one investor company: its registered entities, its profile, what it holds, and its lending and borrowing.
This is a Metered Call. If the data service rejects the request, finds no such company, fails or does not answer in time, the charge is returned to the Account as a Refund.
path Parameters
company_idThe data service’s own identifier for one investor company: a two-letter state code, a colon and the business-registry number. Percent-encode it in the path, so the colon is sent as %3A. An identifier in any other form is refused before anything is charged.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Idempotency-KeyAn opaque string of your choosing that makes retrying this request safe. Optional — a request without one is never an error, and is charged per call. Reusing a key with the same request — the same path and the same query string — within 24 hours returns the stored result and is not charged again, but only when the earlier call succeeded and its response was stored. If the earlier call was refunded or ended without a stored response, the key is taken over: the new request runs and is charged. Otherwise reusing a key with a different request, or on another endpoint, is refused as a conflict, and nothing is charged for it. If an identical request carrying the same key is still in flight, this one waits briefly for that result; if it does not arrive, the response is 409 with a Retry-After header and nothing is consumed for it. Keys are scoped to your Account — one Account never replays another Account’s result.
X-Customer-Reference^[A-Za-z0-9._:-]{1,6…Optional. Your own ID for the customer this call is for — an ID, not a name or email. Shown back to you grouped by customer on the Usage page.
Read an investor company’s profile › Responses
The data service’s answer: a JSON object carrying data and meta. A valid answer with nothing in it is still an answer, and it is charged.
List an investor company’s purchases
Cost: $0.50 per page · desks only
Returns one investor company’s purchases, newest first.
This is a Metered Call. If the data service rejects the request, finds no such company, fails or does not answer in time, the charge is returned to the Account as a Refund.
path Parameters
company_idThe data service’s own identifier for one investor company: a two-letter state code, a colon and the business-registry number. Percent-encode it in the path, so the colon is sent as %3A. An identifier in any other form is refused before anything is charged.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Idempotency-KeyAn opaque string of your choosing that makes retrying this request safe. Optional — a request without one is never an error, and is charged per call. Reusing a key with the same request — the same path and the same query string — within 24 hours returns the stored result and is not charged again, but only when the earlier call succeeded and its response was stored. If the earlier call was refunded or ended without a stored response, the key is taken over: the new request runs and is charged. Otherwise reusing a key with a different request, or on another endpoint, is refused as a conflict, and nothing is charged for it. If an identical request carrying the same key is still in flight, this one waits briefly for that result; if it does not arrive, the response is 409 with a Retry-After header and nothing is consumed for it. Keys are scoped to your Account — one Account never replays another Account’s result.
X-Customer-Reference^[A-Za-z0-9._:-]{1,6…Optional. Your own ID for the customer this call is for — an ID, not a name or email. Shown back to you grouped by customer on the Usage page.
List an investor company’s purchases › Responses
The data service’s answer: a JSON object carrying data and meta. A valid answer with nothing in it is still an answer, and it is charged.
List an investor company’s sales
Cost: $0.50 per page · desks only
Returns what one investor company sold, and to whom.
This is a Metered Call. If the data service rejects the request, finds no such company, fails or does not answer in time, the charge is returned to the Account as a Refund.
path Parameters
company_idThe data service’s own identifier for one investor company: a two-letter state code, a colon and the business-registry number. Percent-encode it in the path, so the colon is sent as %3A. An identifier in any other form is refused before anything is charged.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Idempotency-KeyAn opaque string of your choosing that makes retrying this request safe. Optional — a request without one is never an error, and is charged per call. Reusing a key with the same request — the same path and the same query string — within 24 hours returns the stored result and is not charged again, but only when the earlier call succeeded and its response was stored. If the earlier call was refunded or ended without a stored response, the key is taken over: the new request runs and is charged. Otherwise reusing a key with a different request, or on another endpoint, is refused as a conflict, and nothing is charged for it. If an identical request carrying the same key is still in flight, this one waits briefly for that result; if it does not arrive, the response is 409 with a Retry-After header and nothing is consumed for it. Keys are scoped to your Account — one Account never replays another Account’s result.
X-Customer-Reference^[A-Za-z0-9._:-]{1,6…Optional. Your own ID for the customer this call is for — an ID, not a name or email. Shown back to you grouped by customer on the Usage page.
List an investor company’s sales › Responses
The data service’s answer: a JSON object carrying data and meta. A valid answer with nothing in it is still an answer, and it is charged.