GOV.UK Notify

aid: gov-uk-notify
name: GOV.UK Notify
description: GOV.UK Notify is a UK government notification service operated by the Government Digital Service (GDS) that enables
  central government, local authorities, NHS organisations, and other eligible public bodies to send emails, text messages,
  and letters to citizens on behalf of government services. The platform provides a REST API, a web-based sending interface,
  and official client libraries for Python, Java, .NET, Node.js, PHP, and Ruby. Emails are free and unlimited; SMS messages
  include an annual free allowance by organisation type with per-message overage at 2.4p; physical letters are priced by postage
  class and page count with print and postage included. The API uses JWT-based authentication, supports template-driven personalisation,
  and enforces a throughput limit of 3,000 messages per minute per API key type.
kind: government
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/apis-json-logo.jpg
url: https://raw.githubusercontent.com/api-evangelist/gov-uk-notify/refs/heads/main/apis.yml
tags:
- Notifications
- Email
- SMS
- Text Messages
- Letters
- Government
- United Kingdom
- Public Sector
- GDS
- REST
created: '2026-06-13'
modified: '2026-06-13'
specificationVersion: '0.19'
apis:
- aid: gov-uk-notify:notifications-api
  name: GOV.UK Notify Notifications API
  description: 'The GOV.UK Notify REST API enables government services to programmatically send emails, text messages, and
    letters to citizens. It supports sending individual notifications and bulk sends via pre-defined templates with personalisation
    fields. The API also provides endpoints for retrieving notification status, listing past messages, fetching and previewing
    templates, and accessing received inbound text messages. Authentication uses short-lived JSON Web Tokens (JWT) derived
    from API keys issued per service. Three API key types exist: test (non-persisting), team/guest list (trial mode with recipient
    restrictions), and live (full production access).'
  humanURL: https://docs.notifications.service.gov.uk/rest-api.html
  baseURL: https://api.notifications.service.gov.uk
  tags:
  - Notifications
  - Email
  - SMS
  - Letters
  - REST
  - JWT
  - Templates
  - Government
  properties:
  - type: Documentation
    url: https://docs.notifications.service.gov.uk/rest-api.html
  - type: Website
    url: https://www.notifications.service.gov.uk/
  - type: OpenAPI
    url: openapi/openapi.yml
- aid: gov-uk-notify:python-client
  name: GOV.UK Notify Python Client
  description: Official Python client library for the GOV.UK Notify API. Wraps the REST API with idiomatic Python methods
    for sending SMS, email, and letter notifications; retrieving notification status; listing notifications with filtering;
    fetching templates and previewing them; and handling inbound received text messages. Available on PyPI as notifications-python-client.
  humanURL: https://docs.notifications.service.gov.uk/python.html
  baseURL: https://api.notifications.service.gov.uk
  tags:
  - Python
  - SDK
  - Client Library
  - Notifications
  properties:
  - type: Documentation
    url: https://docs.notifications.service.gov.uk/python.html
  - type: x-github
    url: https://github.com/alphagov/notifications-python-client
- aid: gov-uk-notify:java-client
  name: GOV.UK Notify Java Client
  description: Official Java client library for the GOV.UK Notify API, providing methods for sending emails, SMS messages,
    and letters, as well as retrieving notification statuses and managing templates.
  humanURL: https://docs.notifications.service.gov.uk/java.html
  baseURL: https://api.notifications.service.gov.uk
  tags:
  - Java
  - SDK
  - Client Library
  - Notifications
  properties:
  - type: Documentation
    url: https://docs.notifications.service.gov.uk/java.html
  - type: x-github
    url: https://github.com/alphagov/notifications-java-client
- aid: gov-uk-notify:dotnet-client
  name: GOV.UK Notify .NET Client
  description: Official .NET client library for the GOV.UK Notify API supporting C# and other .NET languages for sending government
    notifications via email, SMS, and letters.
  humanURL: https://docs.notifications.service.gov.uk/net.html
  baseURL: https://api.notifications.service.gov.uk
  tags:
  - .NET
  - C#
  - SDK
  - Client Library
  - Notifications
  properties:
  - type: Documentation
    url: https://docs.notifications.service.gov.uk/net.html
  - type: x-github
    url: https://github.com/alphagov/notifications-net-client
- aid: gov-uk-notify:nodejs-client
  name: GOV.UK Notify Node.js Client
  description: Official Node.js client library for the GOV.UK Notify API for sending government notifications via email, SMS,
    and letters from JavaScript and TypeScript applications.
  humanURL: https://docs.notifications.service.gov.uk/node.html
  baseURL: https://api.notifications.service.gov.uk
  tags:
  - Node.js
  - JavaScript
  - SDK
  - Client Library
  - Notifications
  properties:
  - type: Documentation
    url: https://docs.notifications.service.gov.uk/node.html
  - type: x-github
    url: https://github.com/alphagov/notifications-node-client
- aid: gov-uk-notify:php-client
  name: GOV.UK Notify PHP Client
  description: Official PHP client library for the GOV.UK Notify API for sending government notifications via email, SMS,
    and letters from PHP applications.
  humanURL: https://docs.notifications.service.gov.uk/php.html
  baseURL: https://api.notifications.service.gov.uk
  tags:
  - PHP
  - SDK
  - Client Library
  - Notifications
  properties:
  - type: Documentation
    url: https://docs.notifications.service.gov.uk/php.html
  - type: x-github
    url: https://github.com/alphagov/notifications-php-client
- aid: gov-uk-notify:ruby-client
  name: GOV.UK Notify Ruby Client
  description: Official Ruby client library for the GOV.UK Notify API for sending government notifications via email, SMS,
    and letters from Ruby and Ruby on Rails applications.
  humanURL: https://docs.notifications.service.gov.uk/ruby.html
  baseURL: https://api.notifications.service.gov.uk
  tags:
  - Ruby
  - SDK
  - Client Library
  - Notifications
  properties:
  - type: Documentation
    url: https://docs.notifications.service.gov.uk/ruby.html
  - type: x-github
    url: https://github.com/alphagov/notifications-ruby-client
common:
- type: Website
  url: https://www.notifications.service.gov.uk/
- type: Documentation
  url: https://docs.notifications.service.gov.uk/
- type: Pricing
  url: https://www.notifications.service.gov.uk/pricing
- type: Status
  url: https://status.notifications.service.gov.uk/
- type: Support
  url: https://www.notifications.service.gov.uk/support
- type: Blog
  url: https://gds.blog.gov.uk/category/gov-uk-notify/
- type: x-github
  url: https://github.com/alphagov/notifications-api
- type: Plans
  url: plans/plans.yml
- type: RateLimits
  url: rate-limits/rate-limits.yml
- type: FinOps
  url: finops/finops.yml
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com