Mintly EISCD API (Monthly, v2) (2.0.0)

Every request must carry an X-API-KEY header set to your organisation's unique key. Keep this secret.

X-API-KEY: YOUR_API_KEY

Production is at https://api.mintly.uk/eiscd-base/v2. There is no sandbox environment for this API.

The underlying EISCD is refreshed every Friday from 12:00 GMT, and the data should be treated as valid from the following Monday. Your quota is intended for a single download per calendar month, so whichever snapshot you take is the one published at that point.

We use standard HTTP status codes, including but not limited to:

Status	Meaning
200 OK	The request succeeded. The response body is the file.
403 Forbidden	The API key is missing, invalid or disabled.
404 Not found	The requested file is not available.
429 Too many requests	You have exceeded the rate limit, or used your monthly quota. Wait, then retry.
500 Server error	Something went wrong on our side — get in touch so we can look into it.

Every non-200 response has a JSON body with a Status and a Message field:

{
  "Status": "Invalid",
  "Message": "File not found"
}

A file that does not exist and a file that is not part of your plan both return 404, and are deliberately indistinguishable. Requesting a delta file on this plan therefore returns 404.

The API is designed to be backwards compatible, so changes should not disrupt existing integrations. We follow semantic versioning for API releases. Build your integration to handle non-breaking changes gracefully. If a breaking change ever becomes necessary, we will give advance notice and a clear migration path, and keep the existing version available for a defined deprecation period.

Install the Mintly EISCD agent skill for AI-assisted integration help inside your editor. Once installed, invoke /eiscd-api to generate client code, load the base files into your own store, and schedule a monthly data refresh.

Download the agent skill

Built on the Agent Skills open standard, it works with Claude Code, VS Code (GitHub Copilot), OpenAI Codex, Cursor, Gemini CLI, and many more.