Skip to main content
This guide walks you from zero to a working API call against The Data City v2 API.

​
1. Get an API key

API keys are issued manually by The Data City. Email support@thedatacity.com to request one. See Authentication for the full flow.

​
2. Make your first request

Every request needs an Authorization: Bearer <token> header. Try fetching details for a UK company by its Companies House number: 
curl -X GET 'https://product-api.thedatacity.com/api/v2/companies/12345678' \
  -H 'Authorization: Bearer YOUR_API_KEY'
A successful response is a JSON object with the company’s classification, financials, and metadata. If you get {"message":"Unauthenticated."}, the token is missing or wrong.

​
3. Explore from there

API reference

Every endpoint, with a live playground.

Authentication

How tokens work and what to do if yours stops.

Filtering

Build a list of companies that match RTICs, CICs, or your own criteria.

Batching

Bulk endpoints and company-number sets for large lists.
Last modified on May 19, 2026