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-productions.s3.amazonaws.com/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: [email protected]