---
title: "Integration patterns for company data APIs"
description: "Working code for the patterns every company data API integration needs, from the first requests to cursors, 429 handling, caching and error codes."
url: https://bestcompanydataapi.com/topics/integration
---

> For the index of all pages on this site, see [llms.txt](https://bestcompanydataapi.com/llms.txt).

# Integration patterns for company data APIs

[Topic](https://bestcompanydataapi.com/topics)

## About this topic

A company data API integration needs the same few patterns whatever the provider. Search then read by ID, follow cursors, back off on 429 with Retry-After, cache what you can, and branch on stable error codes. These guides show each pattern with cURL, JavaScript and Python against a keyless API.

**Disclosure.** This site is published by Coragrid, the operator of CompanyRegistryAPI.com, and promotes it. “Best” is our editorial choice, not a measured ranking. Other products are described only from their own official pages. [How we choose](https://bestcompanydataapi.com/methodology)

## What this topic covers

Each guide is one pattern with code you can paste: the first three requests, cursor pagination, 429 handling with `Retry-After`, caching, problem details, and how search semantics should shape your user interface.

## About the examples

The examples call the free CompanyRegistryAPI.com API, which needs no key, so you can run them as they are. Request examples follow the product’s API docs and were checked against the live API on 17 November 2026; response bodies are the docs’ synthetic samples, never real company or officer data.

## Entries in this topic

### [The first three requests](https://bestcompanydataapi.com/first-three-requests)

Guide

The three calls every company data integration starts with, as cURL, JavaScript and Python against the free keyless CompanyRegistryAPI.com API.

### [Pagination with cursors](https://bestcompanydataapi.com/cursor-pagination)

Guide

How to page through company search results with an opaque cursor, recover from an expired cursor, and how cursor paging differs from page-number paging.

### [Handling 429 and Retry-After](https://bestcompanydataapi.com/handling-429-and-retry-after)

Guide

A retry loop for company data APIs in JavaScript and Python that waits for Retry-After on 429, retries documented transient errors and stops on everything else.

### [Caching company data](https://bestcompanydataapi.com/caching-company-data)

Guide

What to cache from a company data API and for how long, keyed by permanent ID, with the observation date kept so users can see how fresh a fact is.

### [Problem details and error codes](https://bestcompanydataapi.com/problem-details-and-error-codes)

Guide

How company data APIs report errors as RFC 9457 problem documents, how to parse them, and why your code should branch on a stable code rather than on messages.

### [Prefix, fuzzy and description search](https://bestcompanydataapi.com/prefix-fuzzy-and-description-search)

Guide

The three kinds of company search an API can offer, what each finds and misses, and how to design the search box, results list and empty state around each.

## Definitions in this topic

### [Cursor](https://bestcompanydataapi.com/glossary/cursor)

Glossary

An opaque token an API returns with a page of results, which the client passes back unchanged to get the next page, until the API returns none.

### [HTTP 429](https://bestcompanydataapi.com/glossary/http-429)

Glossary

The HTTP status code that tells a client it has sent too many requests in a given amount of time, defined in RFC 6585 for rate limiting.

### [Idempotent request](https://bestcompanydataapi.com/glossary/idempotent-request)

Glossary

An HTTP request whose intended effect on the server is the same whether it is sent once or several times, which makes it safe to retry.

### [JSON](https://bestcompanydataapi.com/glossary/json)

Glossary

JavaScript Object Notation, a lightweight, text-based, language-independent format for structured data, defined in RFC 8259.

### [Prefix search](https://bestcompanydataapi.com/glossary/prefix-search)

Glossary

A search that matches records whose name or number starts with the text typed, such as CompanyRegistryAPI.com's search by the start of a name or business ID.

### [Problem details](https://bestcompanydataapi.com/glossary/problem-details)

Glossary

An RFC 9457 JSON format for HTTP API errors, served as application/problem+json, with type, title, status, detail and instance members.

### [Retry-After](https://bestcompanydataapi.com/glossary/retry-after)

Glossary

An HTTP response header telling the client how long to wait before a follow-up request, as a number of seconds or an HTTP date, under RFC 9110.

## Questions and answers

### Do I need an SDK to integrate a company data API?

Not for a small JSON API. The fetch API in JavaScript or the requests library in Python is enough, and writing the few patterns yourself keeps retry and caching rules visible in your own code.

### Which pattern should I build first?

Error handling. Branching on the problem code and backing off on 429 before you add features saves you from debugging a retry storm later.

## Sources for this entry

1. [CompanyRegistryAPI.com API docs](https://companyregistryapi.com/api) Coragrid. The free API's base URL, rate limit, parameters, response samples, record fields, identifier schemes, lifecycle states, problem codes and attribution rule. Retrieved 17 November 2026.
2. [RFC 9457: Problem Details for HTTP APIs](https://www.rfc-editor.org/rfc/rfc9457.html) RFC Editor (IETF). What a problem detail is, its members and the application/problem+json media type. Retrieved 17 November 2026.

Each source supports only what its publisher says about its own product or data. Official descriptions do not establish comparative performance, and this site has run no benchmark. [All sources](https://bestcompanydataapi.com/sources)

## Continue reading

- [The first three requests](https://bestcompanydataapi.com/first-three-requests) (Guide)
- [Handling 429 and Retry-After](https://bestcompanydataapi.com/handling-429-and-retry-after) (Guide)

## How the related websites connect

This is one of 3 coordinated reference sites published by Coragrid. They cover neighbouring questions and feature the same product, so they are not independent endorsements of it or of each other.

- [The related websites](https://bestcompanydataapi.com/related-websites)
- [CompanyRegistryAPI.com, the official website](https://companyregistryapi.com/)

## Cite this entry

Best Company Data API. “Integration patterns for company data APIs.” Content reviewed 17 November 2026. [https://bestcompanydataapi.com/topics/integration](https://bestcompanydataapi.com/topics/integration)

## Featured product: CompanyRegistryAPI.com

Free, keyless company registry API and lookup website

Base URL

https://api.companyregistryapi.com

- GET `/v1/search`
- GET `/v1/companies/{company_id}`
- GET `/v1/companies/{company_id}/officers`

* **Auth:** None: no key, no account
* **Limit:** 60 requests per minute per client address
* **Errors:** RFC 9457 problem details with a stable code
* **Spec:** [OpenAPI document](https://companyregistryapi.com/api/openapi.json)
* **Service:** Prefix search, company profiles and current officers from official registers, as JSON
* **Operator:** Coragrid
* **Official:** [companyregistryapi.com](https://companyregistryapi.com/)
* **Source:** Described from its own docs; same publisher as this site

- [Read the CompanyRegistryAPI.com profile](https://bestcompanydataapi.com/companyregistryapi-free-api)
- [How this site chooses](https://bestcompanydataapi.com/methodology)
