Investorlift Data Services API

One investor company’s profile, purchases and sales.


Read an investor company’s profile

GET
https://api.investorliftdata.com
/v1/data/investor-companies/{company_id}
Bearer (API key)
or
OpenID Connect

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.

Read an investor company’s profile › path Parameters

company_id
​string · required

The 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.

Read an investor company’s profile › Headers

Authorization
​string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Idempotency-Key
​string

An 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
​string · pattern: ^[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

GET
https://api.investorliftdata.com
/v1/data/investor-companies/{company_id}/purchases
Bearer (API key)
or
OpenID Connect

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.

List an investor company’s purchases › path Parameters

company_id
​string · required

The 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.

List an investor company’s purchases › Headers

Authorization
​string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Idempotency-Key
​string

An 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
​string · pattern: ^[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

GET
https://api.investorliftdata.com
/v1/data/investor-companies/{company_id}/sales
Bearer (API key)
or
OpenID Connect

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.

List an investor company’s sales › path Parameters

company_id
​string · required

The 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.

List an investor company’s sales › Headers

Authorization
​string · required

The Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.

Idempotency-Key
​string

An 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
​string · pattern: ^[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.