Integrate

Quick start

From zero to a successful API call. No SDK to install — it is plain HTTPS + JSON from any language.

Request · List covered countries and groups

curl -X GET "https://api.economicsapi.com/v1/countries" \
  -H "Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxx"

Response

{
  "data": [
    {
      "country_id": "id_a1b2c3d4",
      "name": "Acme Corp",
      "slug": "example",
      "iso2": "example",
      "kind": "example",
      "groups": []
    }
  ]
}

1
Create an API key
Sign up at the dashboard, open API keys, create one, and export it: export API_KEY=sk_live_…
2
Make the request
Call List covered countries and groups (GET /v1/countries) with the example on the right. Swap the placeholder values for real ones.
3
Read the response
A 200 with the JSON body shown on the right. Every response includes request_id — store it next to the result.
4
Handle errors
Errors share one envelope: { error, message, request_id }. Branch on error; see Errors.

Let an agent do it

Paste the Integration Prompt into Claude Code or Cursor and it writes the client, wiring, and tests for you.

Integration Prompt

End-to-end integration by an AI coding agent.

MCP Server

Use the API from Claude, Cursor, VS Code.

Next