> ## Documentation Index
> Fetch the complete documentation index at: https://docs.en.amplopay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Search subscriptions

> Query subscriptions created through the API

Queries subscriptions created through the API.

<Warning>
  Avoid frequent polling. Use webhooks to track updates whenever possible.
</Warning>

## Query parameters

<ParamField query="id" type="string">
  Subscription ID.
</ParamField>

<ParamField query="identifier" type="string">
  Subscription identifier sent by your application.
</ParamField>

<ParamField query="status" type="string">
  Subscription status filter.
</ParamField>

## Request example

<RequestExample>
  ```bash theme={null}
  curl --request GET \
    --url 'https://app.amplopay.com/api/v1/gateway/subscriptions?identifier=assinatura-123' \
    --header 'x-public-key: SUA_CHAVE_PUBLICA_AQUI' \
    --header 'x-secret-key: SUA_CHAVE_PRIVADA_AQUI'
  ```
</RequestExample>