Gov APIdvla.gov.gh ↗
Access Ghana DVLA fees, service prices, FAQs, news posts, and the nationwide office directory via 7 structured JSON endpoints.
What is the Gov API?
The DVLA Ghana API exposes 7 endpoints covering the public data published by Ghana's Driver and Vehicle Licensing Authority at dvla.gov.gh: fee catalogues with tiered rate breakdowns, headline service prices, news and press releases with full HTML bodies, an FAQ listing, and a nationwide office directory. The list_fees endpoint alone returns per-row price amounts, category labels, and multi-tier rate details for every chargeable DVLA service.
curl -X GET 'https://api.parse.bot/scraper/fc324241-f85d-4c8b-9d4f-23fd4a5fc598/list_fees?limit=2&query=certificate+of+ownership&category=pvts-roadworthy' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace dvla-gov-gh-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: DVLA Ghana SDK — fees, news, offices; every call capped."""
from parse_apis.dvla_gov_gh_api import DvlaGh, FeeCategory, PostNotFound
client = DvlaGh()
# Browse roadworthy fees with the category filter.
for fee in client.fees.list(category=FeeCategory.PVTS_ROADWORTHY, limit=3):
print(fee.title, fee.price, f"({len(fee.rates)} rate tiers)")
# List recent news posts and drill into the first one by its id.
post = client.posts.list(limit=1).first()
if post is not None:
detail = client.posts.get(id=post.id)
print(detail.title, detail.author_name, detail.published_at)
if detail.attachment is not None:
print(" attachment:", detail.attachment.file_name, detail.attachment.file_size_bytes, "bytes")
# Point-lookup with error handling for a missing post.
try:
client.posts.get(id=999999)
except PostNotFound as e:
print("post not found:", e.message)
# Head office contact info from the office directory.
directory = client.office_directory.get()
if directory.head_office is not None:
hq = directory.head_office
print(hq.address, hq.phone, hq.weekday_hours)
for group in directory.office_groups[:3]:
print(group.group, "-", group.active_stations, "stations")
print("exercised: fees.list / posts.list / posts.get / office_directory.get")
Returns the DVLA fees-and-charges catalogue as shown on the site's Fees and Charges page: one row per chargeable service with its headline price and the full breakdown of rate tiers (for example Standard/Premium/Prestige for licensing and registration, or Testing/Roadworthy/Service Charge/Total for roadworthy items). Prices are Ghana cedis (GHS); each price is returned both as the site's display string and as a parsed number. official_rate is the price the site's official-rates feed publishes for a fee whose title matches exactly; it is null for the majority of rows, which the feed does not cover. Filtering by category and by free-text query is applied locally over the whole catalogue (every word of the query must appear in the title or description), and the result is paginated with limit/offset over the filtered set; total is the filtered count. Omitting limit returns 50 rows (capped at 100), omitting offset starts at 0. The whole catalogue is loaded on every call (three to five requests), so fetching all pages costs no more per page than the first.
| Param | Type | Description |
|---|---|---|
| limit | integer | Rows per page, capped at 100. |
| query | string | Free-text filter; every word must appear in the fee title or description (case-insensitive). Omitted = no text filter. |
| offset | integer | Zero-based index into the filtered result set. |
| category | string | Restrict to one fee category. Omitted = all categories. |
{
"type": "object",
"fields": {
"fees": "array of fee rows: id, title, description, category, price (display string), price_amount (number), currency, official_rate (display string or null), official_rate_amount (number or null), rates (array of {label, price, amount})",
"limit": "page size applied",
"total": "number of fee rows matching the filters",
"offset": "offset applied",
"has_more": "true when offset + returned rows is below total"
},
"sample": {
"data": {
"fees": [
{
"id": "pvts-motor-cyclesup-to-200cc-4",
"price": "GHS 58.00",
"rates": [
{
"label": "Vehicle Testing Fee",
"price": "GHS 11.00",
"amount": 11
},
{
"label": "Roadworthy Fee",
"price": "GHS 25.00",
"amount": 25
},
{
"label": "Service Charge",
"price": "GHS 22.00",
"amount": 22
},
{
"label": "Total Fee",
"price": "GHS 58.00",
"amount": 58
}
],
"title": "Motor Cycles(Up to 200cc)",
"category": "pvts-roadworthy",
"currency": "GHS",
"description": "Vehicle testing and roadworthy fee for Motor Cycles(Up to 200cc)",
"price_amount": 58,
"official_rate": null,
"official_rate_amount": null
}
],
"limit": 3,
"total": 37,
"offset": 0,
"has_more": true
},
"status": "success"
}
}About the Gov API
Fees, Charges, and Service Prices
The list_fees endpoint returns the full fees-and-charges catalogue, with each row carrying title, description, category, price (display string), price_amount (numeric), currency, and an official_rate breakdown that captures tier structures such as Standard/Premium/Prestige for licensing and registration, or Testing/Roadworthy/Service for vehicle inspection. Results are paginated via limit and offset parameters (capped at 100 rows per page), and a query string filters rows where every word matches the fee title or description. The complementary list_services endpoint returns a shorter curated list of headline service prices, each tagged with a category such as driver-licensing or vehicle-registration.
News, Press Releases, and Categories
list_news returns posts from the News & Updates section ordered newest-first. Each post includes content_html, content_text, featured_image_url, author_name, categories, published_at, views, and shares counters. Document-type posts also carry an attachment object with file_name, file_size_bytes, and url. The optional category parameter accepts a slug from list_news_categories, which returns the full news taxonomy (id, name, slug, optional description). A single post can be fetched by numeric id via get_news_post; an unknown id returns a stale_input error.
FAQs and Office Directory
list_faqs returns every published FAQ entry in one request — each with question, answer, category, topic, optional image_url, and updated_at. list_offices returns the full station directory grouped as Regional Offices, District Offices, Ultra Centers, Satellite Offices, and Special Initiatives. The response includes a head_office block (address, phone, toll_free, email, weekday_hours, weekend_hours) and an office_groups array where each group carries its active_stations count and an array of office name objects. The total_offices field sums all station names across groups.
The Gov API is a managed, monitored endpoint for dvla.gov.gh — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when dvla.gov.gh changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official dvla.gov.gh API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Build a DVLA fee calculator that filters
list_feesbycategoryand displays tier breakdowns for licensing or vehicle registration. - Populate a driver's checklist app with official service prices from
list_services, tagged bydriver-licensingorvehicle-registrationcategory. - Aggregate DVLA press releases and annual reports from
list_news, filtering by category slug and parsingattachmentfields for PDF downloads. - Index the full DVLA FAQ corpus from
list_faqsinto a search interface using thequestion,answer, andtopicfields. - Render a nationwide DVLA office locator by consuming
list_officesgrouped data, distinguishing Regional, District, and Ultra Center types. - Monitor new DVLA notices by polling
list_newswithoffset=0and comparing the latestpublished_attimestamps. - Sync DVLA service pricing into a government-services comparison tool using
price_amountnumeric fields fromlist_feesandlist_services.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does DVLA Ghana have an official developer API?+
How does the `list_fees` category filter work, and what categories are available?+
category parameter to restrict results to one fee category. The available category values match those returned in the category field of existing fee rows — for example, categories covering licensing, registration, or vehicle inspection tiers. Omitting the parameter returns all categories. You can page through results with limit and offset, and apply a query string to match words in the fee title or description.Does `list_offices` return full address details or contact numbers for individual branch offices?+
office_groups[*].offices carries only the station name. Full address, phone, and hours details are returned only for the head_office block. The API covers all groupings (Regional, District, Ultra Centers, Satellite, Special Initiatives) and their active_stations counts. You can fork the API on Parse and revise it to add the missing per-branch contact fields.Can I look up a vehicle's registration or licence status using this API?+
Are news posts from `list_news` always complete, and how should I handle document attachments?+
list_news includes content_html and content_text for the full body. For document-type posts such as annual reports or gazettes, the attachment field contains file_name, file_size_bytes, and a direct url to the file. Non-document posts return null for attachment. The total field in the response reflects the site's own count, so pagination via limit and offset may not always align with the site total if posts are added or removed between requests.