---
title: "Search services by name or merchant name"
method: POST
path: "/v1/api/services/search"
tags: ["Services"]
---

# Search services by name or merchant name

`POST /v1/api/services/search`

This endpoint returns a list of services using lexical meaning to determine a match to the search criteria

## Request body

- string

## Response `200`

OK

- SearchServicesResponse
  - `merchant_results` Service[]
    - `_links` Link[]
      - `href` string
      - `method` string
      - `rel` string
    - `agent_initiated_moto_enabled` boolean
    - `archived` boolean
    - `archived_date` string, date-time
    - `collect_billing_address` boolean
    - `created_date` string, date-time
    - `current_go_live_stage` 'NOT_STARTED' | 'ENTERED_ORGANISATION_NAME' | 'ENTERED_ORGANISATION_ADDRESS' | 'CHOSEN_PSP_ADYEN' | 'CHOSEN_PSP_STRIPE' | 'CHOSEN_PSP_GOV_BANKING_WORLDPAY' | 'GOV_BANKING_MOTO_OPTION_COMPLETED' | 'TERMS_AGREED_ADYEN' | 'TERMS_AGREED_STRIPE' | 'TERMS_AGREED_GOV_BANKING_WORLDPAY' | 'DENIED' | 'LIVE'
    - `current_psp_test_account_stage` 'NOT_STARTED' | 'REQUEST_SUBMITTED' | 'CREATED'
    - `custom_branding` object
    - `default_billing_address_country` string
    - `experimental_features_enabled` boolean
    - `external_id` string
    - `gateway_account_ids` string[]
    - `id` integer
    - `internal` boolean
    - `merchant_details` MerchantDetails
      - `address_city` string
      - `address_country` string
      - `address_line1` string
      - `address_line2` string
      - `address_postcode` string
      - `email` string
      - `name` string
      - `telephone_number` string
      - `url` string
    - `name` string
    - `redirect_to_service_immediately_on_terminal_state` boolean
    - `sector` string
    - `service_features` object
    - `service_name` object
    - `takes_payments_over_phone` boolean
    - `went_live_date` string, date-time
  - `name_results` Service[]
    - `_links` Link[]
      - `href` string
      - `method` string
      - `rel` string
    - `agent_initiated_moto_enabled` boolean
    - `archived` boolean
    - `archived_date` string, date-time
    - `collect_billing_address` boolean
    - `created_date` string, date-time
    - `current_go_live_stage` 'NOT_STARTED' | 'ENTERED_ORGANISATION_NAME' | 'ENTERED_ORGANISATION_ADDRESS' | 'CHOSEN_PSP_ADYEN' | 'CHOSEN_PSP_STRIPE' | 'CHOSEN_PSP_GOV_BANKING_WORLDPAY' | 'GOV_BANKING_MOTO_OPTION_COMPLETED' | 'TERMS_AGREED_ADYEN' | 'TERMS_AGREED_STRIPE' | 'TERMS_AGREED_GOV_BANKING_WORLDPAY' | 'DENIED' | 'LIVE'
    - `current_psp_test_account_stage` 'NOT_STARTED' | 'REQUEST_SUBMITTED' | 'CREATED'
    - `custom_branding` object
    - `default_billing_address_country` string
    - `experimental_features_enabled` boolean
    - `external_id` string
    - `gateway_account_ids` string[]
    - `id` integer
    - `internal` boolean
    - `merchant_details` MerchantDetails
      - `address_city` string
      - `address_country` string
      - `address_line1` string
      - `address_line2` string
      - `address_postcode` string
      - `email` string
      - `name` string
      - `telephone_number` string
      - `url` string
    - `name` string
    - `redirect_to_service_immediately_on_terminal_state` boolean
    - `sector` string
    - `service_features` object
    - `service_name` object
    - `takes_payments_over_phone` boolean
    - `went_live_date` string, date-time

## Other responses

- `400` — Invalid JSON payload

## Changes

- **2026-08-03** `17f1bf916172` — 2 breaking
  - the `merchant_results/items/service_features` response's property type/format changed from `array`/`` to `object`/`` for status `200`
  - the `name_results/items/service_features` response's property type/format changed from `array`/`` to `object`/`` for status `200`
- **2026-07-21** `1f9978f5e174` — 2 info
  - added the optional property `merchant_results/items/service_features` to the response with the `200` status
  - added the optional property `name_results/items/service_features` to the response with the `200` status
- **2026-06-15** `7c2ffa5bfb93` — 4 warning
  - added the new `CHOSEN_PSP_ADYEN` enum value to the `merchant_results/items/current_go_live_stage` response property for the response status `200`
  - added the new `CHOSEN_PSP_ADYEN` enum value to the `name_results/items/current_go_live_stage` response property for the response status `200`
  - added the new `TERMS_AGREED_ADYEN` enum value to the `merchant_results/items/current_go_live_stage` response property for the response status `200`
  - added the new `TERMS_AGREED_ADYEN` enum value to the `name_results/items/current_go_live_stage` response property for the response status `200`
- **2023-11-09** `de931ca0f448` — 2 info
  - added the optional property `merchant_results/items/archived_date` to the response with the `200` status
  - added the optional property `name_results/items/archived_date` to the response with the `200` status
- …earlier changes not shown

[Full history](https://skmtc.dev/government-digital-service/apis/adminusers-api/changes/v1/api/services/search/post.md)

---

[API](https://skmtc.dev/government-digital-service/apis/adminusers-api.md) · [All operations](https://skmtc.dev/government-digital-service/apis/adminusers-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/government-digital-service/adminusers-api/revisions/8f9d543f352b/schema)