> ## Documentation Index > Fetch the complete documentation index at: https://evsim.synergyboat.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # API overview > Automate the EV Roaming Tester with an API key: partner connections, conformance runs, charging journeys, and the graded reports and usage they produce. The EV Roaming Tester has one public API. It is the HTTP surface you automate with an **API key** against the deployed service: ```text theme={null} https://evsim.synergyboat.com ``` All operations live under `/api/v1` and authenticate with a Bearer API key that starts with `evrt_`. There is no other supported base URL and no environment selector. ```bash theme={null} curl -fsS "https://evsim.synergyboat.com/api/v1/connections" \ -H "Authorization: Bearer $EVRT_KEY" ``` ## What you can automate | Area | Operations | | ----------------- | ------------------------------------------------------------------------------------------------------------------------------ | | Connections | Create a partner connection, register it (the live OCPI credentials handshake), list and read your connections. | | Suites | List the conformance suites available to run. | | Conformance runs | Start a run, wait for or poll it, list runs, read the full report, delete a run, mint a share link. | | Manual command | Send one bounded OCPI request through a registered connection and get the exact exchange back. | | Charging journeys | Browse the catalogue, preview a plan, start a run idempotently, stream its events, cancel it, and resolve a recovery decision. | | Usage | Read your plan tier, current usage and ceilings. | Only the operations in the API reference section of this site are public API. Everything else the application does (the interactive simulator, entity editing, account and key management) is browser functionality, not part of this contract. ## Authentication Every request sends the key in the `Authorization` header: ```text theme={null} Authorization: Bearer $EVRT_KEY ``` API keys are created and revoked in the app, in **Settings, then Security**, and require a paid plan. There is no API for managing keys: a key cannot mint, list or revoke other keys. See [Create an API key](/docs/guide/create-an-api-key). ## Response envelope Every response is JSON. Successes wrap their payload: ```json theme={null} { "success": true, "data": {} } ``` Errors carry an HTTP 4xx or 5xx status and a message: ```json theme={null} { "success": false, "message": "Report not found" } ``` Two statuses deserve a special mention because CI scripts get them wrong: * A `202` means the work was accepted and is **still going**. It is not a success verdict and not a failure. Poll or wait for the result instead of gating on it. * A `503` on a charging journey start means **our runner is unavailable**. It is a statement about our service, never a verdict about your partner's implementation. The full status-code table is in [Troubleshooting](/docs/guide/troubleshooting). ## Limits and usage Plans set ceilings on connections, active API keys, runs per minute and runs in flight. Read your own numbers instead of hardcoding them: ```bash theme={null} curl -fsS "https://evsim.synergyboat.com/api/v1/usage" \ -H "Authorization: Bearer $EVRT_KEY" | jq '.data' ``` The response reports your tier, active connections against their cap, active keys against their cap, in-flight and per-minute run ceilings, and your report retention window. A request over a ceiling returns an explicit `429` with a `Retry-After` header. An in-flight charging journey holds one run slot until it reaches a terminal state, and a run waiting on a recovery decision keeps holding its slot until you decide. ## Where to go next Sign in, create the key in Settings, store it once. A complete conformance run from the command line. Register a real partner endpoint and run against it. Drive a full charging story and watch it live.