canonical: https://jentic.com/apis/appealgo.com/appealgo # AppealGo API The AppealGo API scans a UK parking ticket, council PCN, private parking charge, bus lane, ULEZ, or Clean Air Zone notice, returns the grounds for an appeal with a drafted response, and files that appeal with the issuing authority. Checking a notice is free; filing is charged per notice or covered by a plan. Alongside the notice workflow it exposes free public lookups: a status check by customer reference, searchable appeal guides served as Markdown, contravention code explanations, and a statutory deadline calculator. ## For AI agents Scan a UK traffic or parking notice, get the grounds and a drafted appeal, and file it with the issuing authority. Authenticates with a bearer key for the notice workflow; status, guides, codes, and deadline lookups are public. ## Scope Does not pay the original fine, provide court representation, or handle non-UK traffic penalties. Use for checking, drafting, and filing appeals against UK parking and traffic notices only. ## Capabilities - Scan a UK parking ticket, PCN, bus lane, ULEZ, or Clean Air Zone notice to get the grounds for appeal - File a drafted appeal against a notice with the issuing authority - Calculate the statutory appeal deadlines for a notice - Look up and explain a contravention code - Search the appeal guides and read them as Markdown - Check an appeal's status by customer reference ## Use cases ### Agent-Assisted Parking Appeal An AI agent connected through Jentic scans a photographed parking or traffic notice, reads back the grounds AppealGo found and the drafted appeal, and files it with the issuing authority once a person approves. Because checking is free and filing is a separate paid step, the agent can assess a ticket's merits before anything is submitted. Example prompt: Scan this parking notice, summarise the grounds for appeal, and file the appeal only if the grounds are strong ### Deadline and Grounds Triage A workflow scans each incoming notice and calculates its statutory appeal deadline so an operator sees which tickets must be answered first and which have the strongest grounds. The deadline calculator and the scan grounds together turn a pile of notices into a prioritised queue. Example prompt: For each notice, return its appeal deadline and the grounds found, sorted by the soonest deadline ### Contravention Code Lookup A support tool resolves a contravention code into a plain explanation and pulls the relevant appeal guide so a user understands what they were charged for and how to contest it. The code explanations and Markdown guides make the lookup self-contained for an answer engine or chatbot. Example prompt: Explain the contravention code on this notice and return the matching appeal guide ## Key endpoints | Method | Path | Description | | --- | --- | --- | | GET | `/notices` | List this account's notices | | POST | `/notices` | Scan a notice | | POST | `/notices/{id}/file` | File the appeal | | GET | `/codes` | List or search contravention codes | | GET | `/deadlines` | Calculate statutory deadlines for a notice | | GET | `/guides` | Search the appeal guides | ## Key resources - **Notices** — Scanned parking and traffic notices, their grounds, drafted appeals, and filing status - **Guides** — Searchable appeal guides served as Markdown - **Contravention codes** — Lookups and explanations for UK contravention codes - **Deadlines** — Statutory appeal deadline calculations for a notice ## AI readiness This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use. - **Score:** 40 / 100 - **Maturity:** Foundational - **Dimensions:** - Foundational Compliance: 72 / 100 - Developer Experience & Jentic Compatibility: 60 / 100 - AI-Readiness & Agent Experience: 18 / 100 - Agent Usability: 94 / 100 - Security: 60 / 100 - AI Discoverability: 53 / 100 - **View full report:** https://jentic.com/apis/appealgo.com/appealgo/scorecard - **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/ - **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview ### Score it yourself Every API in the directory is allowlisted, so you can re-score it with no key required. - **Score your own API:** https://jentic.com/scorecard.md - **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md ```sh npx @jentic/api-scorecard-cli score ``` ## Why Jentic - **Setup:** Wiring the AppealGo API by hand means creating and carrying a bearer key, separating the free public lookups from the authenticated scan-and-file calls, and respecting the per-key scan budget. Through Jentic you install once, import AppealGo from the API Directory, store the key once, and your agent calls it. - **Permission scoping:** AppealGo puts the notice id in the URL path, so a rule can let your agent scan and check notices while leaving the file-the-appeal operation out, or pin it to acting on one notice. You choose the operations it may call, so filing an appeal is not included unless you add it. - **Credential handling:** Your AppealGo key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context. - **Discovery method:** Agents search Jentic by intent such as 'scan a parking ticket' or 'check an appeal deadline', and Jentic returns the matching AppealGo operation with its input schema so the agent calls the right endpoint without reading the reference docs. ## Related APIs - **GOV.UK API** — Official UK government platform for public service content and data - **UniCourt Enterprise APIs** — Court records, case data, and litigation analytics ## FAQ ### Is there an AppealGo MCP server? Yes. AppealGo offers an MCP server that exposes the same operations. You can also connect it directly through Jentic: your agent gets the full 13-endpoint surface without loading another server's tool definitions into its context, your key is injected at call time by your self-hosted instance instead of living in a config file, and your rules decide which operations the agent may call. ### Can I limit what my agent is allowed to do with the AppealGo API? Yes. Write a rule that allows scanning a notice and reading its status and deadlines but not the file-the-appeal operation, so the agent can assess a ticket without ever submitting an appeal on your behalf, and every call it makes is logged. Because the notice id is in the URL path, you can also bound the agent to one notice. ### What authentication does the AppealGo API use? The AppealGo API authenticates with a bearer token, an ag_live_ key you create in your profile, per its OpenAPI spec. The public status, guide, contravention-code, and deadline lookups need no key. Through Jentic the key is stored encrypted by your own instance and added at call time, so it never appears in the agent's prompt or logs. ### Can I check whether a parking ticket is worth appealing with the AppealGo API? Yes. Scanning a notice returns the grounds AppealGo found plus a drafted appeal, and the deadline endpoint returns the statutory dates for that notice, so an agent can judge both the merits and the timing before anything is filed. Checking a notice is free, and only the filing step is charged. ### What are the rate limits for the AppealGo API? Each API key may run 25 scans per day according to the API's own description; the spec does not publish limits for the free lookup endpoints. For current limits and plan allowances, see the AppealGo documentation at https://appealgo.com. ### How do I file a parking appeal with the AppealGo API through Jentic? Import the AppealGo API from the Jentic API Directory, then have your agent issue a request such as 'scan this parking ticket and file an appeal if there are grounds'. Jentic matches the intent to the scan and file operations and returns their input schemas so the agent builds the right calls, with your stored key injected at call time. To run it on your own infrastructure, install Jentic One from its GitHub repo.