---
title: "Tax filing and payment deadlines due in a month. Pro and Compliance"
method: GET
path: "/v1/countries/{country}/deadlines"
tags: ["Tax data"]
---

# Tax filing and payment deadlines due in a month. Pro and Compliance

`GET /v1/countries/{country}/deadlines`

## Request

- Base URL: `https://api.africacompliancedata.com`
- URL: `https://api.africacompliancedata.com/v1/countries/{country}/deadlines`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Due dates are adjusted for weekends and public holidays where the country's rule (weekend_adjust) or the deadline's own rule is known; otherwise the statutory date is returned with adjusted: false. statutory_date shows the date before adjustment. Rules without a fixed calendar date are listed in other_rules.

## Path parameters

- `country` string, required

## Query parameters

- `year` integer, required
- `month` integer, required

## Response `200`

Deadlines

- object
  - `country` string, required
  - `country_name` string
  - `coverage` 'ready' | 'partial' | 'gap', required
  - `warning` string: When coverage is partial or gap, the year's holiday list is incomplete, or no value can be given
  - `sources` object, required
  - `dataset_version` string, required
  - `disclaimer` string, required
  - `year` integer
  - `month` integer
  - `weekend_adjust` string
  - `due` object[]
    - `tax` string
    - `frequency` string
    - `statutory_date` string, date
    - `due_date` string, date
    - `adjusted` boolean
    - `period` string, nullable
    - `description` string
  - `other_rules` object[]
    - `tax` string
    - `frequency` string
    - `description` string
  - `notes` string, nullable

## Other responses

- `400`: Missing or invalid parameter
- `401`: Missing or invalid API key
- `403`: Tax data needs the Pro or Compliance plan (or the key is paused for review)
- `404`: Unknown country, path or webhook id
- `429`: Rate limit for the plan exceeded, or key checks busy (many new keys from your network); see Retry-After
- `503`: Key check temporarily unavailable, or webhook storage unavailable (webhook endpoints); retry after Retry-After seconds

---

[API](https://skmtc.dev/africacompliancedata/apis/africa-compliance-data-api.md) · [All operations](https://skmtc.dev/africacompliancedata/apis/africa-compliance-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/africacompliancedata/apis/africa-compliance-data-api/revisions/cb17c8aafda8?raw)
