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
accessModel:
  pricing: free
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Free · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/gov-uk-notify.png
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: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
- aid: gov-uk-notify:gov-uk-notify-notifications-api
  name: GOV.UK Notify Notifications API
  description: Send and retrieve notifications (email, SMS, letters)
  humanURL: https://docs.notifications.service.gov.uk/rest-api.html
  baseURL: https://api.notifications.service.gov.uk
  tags:
  - Notifications
  properties:
  - type: OpenAPI
    url: openapi/gov-uk-notify-notifications-api-openapi.yml
  - type: Documentation
    url: https://docs.notifications.service.gov.uk/rest-api.html
  - type: Website
    url: https://www.notifications.service.gov.uk/
- aid: gov-uk-notify:gov-uk-notify-received-text-messages-api
  name: GOV.UK Notify Received Text Messages API
  description: Retrieve inbound text messages
  humanURL: https://docs.notifications.service.gov.uk/rest-api.html
  baseURL: https://api.notifications.service.gov.uk
  tags:
  - Received Text Messages
  properties:
  - type: OpenAPI
    url: openapi/gov-uk-notify-received-text-messages-api-openapi.yml
  - type: Documentation
    url: https://docs.notifications.service.gov.uk/rest-api.html
  - type: Website
    url: https://www.notifications.service.gov.uk/
- aid: gov-uk-notify:gov-uk-notify-templates-api
  name: GOV.UK Notify Templates API
  description: Retrieve and preview notification templates
  humanURL: https://docs.notifications.service.gov.uk/rest-api.html
  baseURL: https://api.notifications.service.gov.uk
  tags:
  - Templates
  properties:
  - type: OpenAPI
    url: openapi/gov-uk-notify-templates-api-openapi.yml
  - type: Documentation
    url: https://docs.notifications.service.gov.uk/rest-api.html
  - type: Website
    url: https://www.notifications.service.gov.uk/
common:
- type: AgenticAccess
  url: agentic-access/gov-uk-notify-agentic-access.yml
- type: VulnerabilityDisclosure
  url: security/gov-uk-notify-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/gov-uk-notify-domain-security.yml
- type: Authentication
  url: authentication/gov-uk-notify-authentication.yml
- 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