> ## Documentation Index
> Fetch the complete documentation index at: https://www.dropfans.io/developers/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /api/external/v1/chat-gate — Get the Pay to Chat setting

> The creator’s Pay to Chat / Sub to Chat setting, or with `account` the one that applies to that Telegram account.

- Source: https://www.dropfans.io/developers/reference/get-chat-gate
- Section: API reference
- OpenAPI: https://www.dropfans.io/developers/openapi.json

Also served at `/api/external/chat-gate` (the unversioned alias).

The creator’s Pay to Chat / Sub to Chat setting, or with `account` the one that applies to that Telegram account.

An account’s own setting wins over the creator’s. The response also carries the subscription Sub to Chat sells, the chatbots on the creator’s accounts and the accounts with their own setting. See [Pay to Chat from your own chatbot](https://www.dropfans.io/developers/guides/pay-to-chat.md).

## Authentication

`Authorization: Bearer dpfn_...` — an API key generated in the dashboard (Vault → API Connect). By default the key acts for the one account it belongs to. Missing or invalid keys return 401 `{"error":"Unauthorized","code":"unauthorized"}`.

**For a creator you manage or onboarded:** `GET /api/external/v1/creators/{creatorId}/chat-gate` — with a verified agency's own key for a creator or AI persona it manages, or your app owner's own key for an account your app onboarded (ids from GET /api/external/v1/creators); for a managed creator the agency needs `canManageDrops`. The response echoes the account acted on in `X-Dropfans-Account`. Sending `X-Dropfans-Account: <account id>` on the plain path still works but is deprecated.

## Query parameters

| Field | Type | Required | Description |
|---|---|---|---|
| `account` | string |  | Telegram user id of one of the creator’s accounts. |

## Responses

### 200

The setting.

| Field | Type | Required | Description |
|---|---|---|---|
| `account` | string \\| null | yes | The account asked about, or null for the creator’s setting. |
| `mode` | `EVERYONE` \\| `PAY` \\| `SUB` | yes | Who may chat: everyone, fans who paid (tip or drop) or subscribed, or subscribers only. |
| `payScope` | `ONCE` \\| `PER_CONVERSATION` | yes | Pay to Chat: `ONCE` = paid once, open for good; `PER_CONVERSATION` = a conversation can be ended and the fan pays again. |
| `source` | `account` \\| `creator` | yes | `account`: that Telegram account has its own setting; `creator`: the creator’s applies. |
| `tier` | object \\| null | yes | The subscription Sub to Chat sells; null when none is on sale (Sub to Chat then asks nobody). |
| `tier.priceUsd` | number | yes | Price per interval, USD. |
| `tier.interval` | string | yes | Billing interval. |
| `chatbots` | object[] | yes | Chatbots reported on the creator’s accounts: ours (app `Dropfans`) and partner apps’. |
| `accountSettings` | object[] | yes | Accounts with their own setting. |

```json
{
  "account": null,
  "mode": "PAY",
  "payScope": "ONCE",
  "source": "creator",
  "tier": {
    "priceUsd": 14.99,
    "interval": "month"
  },
  "chatbots": [
    {
      "account": "5550001111",
      "app": "Your CRM",
      "botUsername": "your_bot",
      "enabled": true,
      "canReply": true,
      "updatedAt": "2026-11-12T10:00:00.000Z"
    }
  ],
  "accountSettings": [
    {
      "account": "5550002222",
      "mode": "SUB",
      "payScope": "ONCE"
    }
  ]
}
```

## Errors

| Status | Body | When |
|---|---|---|
| 400 | `{"error":"account must be a Telegram user id (digits, as a string)","code":"invalid_telegram_id"}` | `account` is missing or not a Telegram user id. |
| 401 | `{"error":"Unauthorized","code":"unauthorized"}` | Missing or invalid API key. |
| 403 | `{"error":"This endpoint needs a key bound to an app with the chat_gate API category enabled — personal keys cannot use it.","code":"app_key_required","category":"chat_gate"}` | A personal key: the chat gate answers back through app webhooks. |
| 409 | `{"error":"The chat gate is for creator accounts.","code":"not_a_creator"}` | The account is a fan account, suspended or banned. |
| 503 | `{"error":"The chat gate is not available right now. Let the message through.","code":"unavailable"}` | Something failed on our side. Fail open: let the message stand. |
| 400 | `{"error":"X-Dropfans-Account must be an account id (from GET /api/external/agency/creators), not a username.","code":"invalid_account_header"}` | `X-Dropfans-Account` is not an account id. |
| 400 | `{"error":"X-Dropfans-Account names a different account than the path — send one or the other.","code":"account_mismatch"}` | Called under /v1/creators/{creatorId}/ with an `X-Dropfans-Account` naming another account. |
| 403 | `{"error":"This key cannot act for that account.","code":"account_not_managed"}` | The creator in the path (or `X-Dropfans-Account`) is one this key cannot act for: no ACCEPTED management by your agency and not an account your app onboarded (or it no longer holds a key bound to your app), a key minted for one creator, or someone is suspended, banned or deleted. An unknown id gets the same answer. |
| 403 | `{"error":"The agency does not have permission for this on that account.","code":"permission_denied","permission":"canManageDrops"}` | For a managed creator: the agency lacks `canManageDrops` on that account. |
| 403 | `{"error":"This app does not have the chat_gate API category enabled. Contact support to enable it.","code":"api_category_disabled","category":"chat_gate"}` | Your app has the Pay to Chat [API category](https://www.dropfans.io/developers/concepts/api-categories.md) switched off (the default for new apps). |

## Rate limiting

Per-key fixed windows by tier (Personal 60/min · 5,000/day; approved apps 300/min · 50,000/day; Dropfans-operated integrations exempt). Read the live values from X-RateLimit-Tier, X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset and their -Day variants; a 429 carries Retry-After and `{"error":"Rate limit exceeded","code":"rate_limited"}`. See [Rate limits](https://www.dropfans.io/developers/concepts/rate-limits.md).

## Code samples

### curl

```bash
curl "https://www.dropfans.io/api/external/v1/chat-gate?account=5550001111" \
  -H "Authorization: Bearer $DROPFANS_API_KEY"
```

### Node

```javascript
const res = await fetch(`https://www.dropfans.io/api/external/v1/chat-gate?account=5550001111`, {
  headers: {
    Authorization: `Bearer ${process.env.DROPFANS_API_KEY}`,
  },
});
console.log(await res.json());
```

### Python

```python
import os
import requests

res = requests.get(
    "https://www.dropfans.io/api/external/v1/chat-gate",
    headers={"Authorization": f"Bearer {os.environ['DROPFANS_API_KEY']}"},
    params={"account": "5550001111"},
)
print(res.json())
```

## OpenAPI

```json
{
  "method": "GET",
  "path": "/api/external/v1/chat-gate",
  "operationId": "getChatGate",
  "tags": [
    "chatgate"
  ],
  "summary": "Get the Pay to Chat setting",
  "description": "The creator’s Pay to Chat / Sub to Chat setting, or with `account` the one that applies to that Telegram account.\n\nAn account’s own setting wins over the creator’s. The response also carries the subscription Sub to Chat sells, the chatbots on the creator’s accounts and the accounts with their own setting. See [Pay to Chat from your own chatbot](https://www.dropfans.io/developers/guides/pay-to-chat.md).",
  "parameters": [
    {
      "name": "account",
      "in": "query",
      "required": false,
      "description": "Telegram user id of one of the creator’s accounts.",
      "schema": {
        "type": "string"
      },
      "example": "5550001111"
    },
    {
      "name": "X-Dropfans-Account",
      "in": "header",
      "required": false,
      "deprecated": true,
      "description": "Deprecated: call the …ForCreator operation (/api/external/v1/creators/{creatorId}/…) instead; the header keeps working and such responses carry Deprecation and Link: rel=\"successor-version\". With a verified agency’s own key, the id of a creator or AI persona the agency manages (from GET /api/external/v1/agency/creators): the request then acts as that account, exactly as if it were sent with that account’s own key. Account ids only — usernames are refused (400 invalid_account_header). Checked on every request: the management must be ACCEPTED, nobody may be suspended, banned or deleted (else 403 account_not_managed), and the agency needs the endpoint’s permission on that account (else 403 permission_denied). Omit it to act as the key’s own account.",
      "schema": {
        "type": "string",
        "pattern": "^c[a-z0-9]{20,32}$"
      },
      "example": "cmh4v2q8k0003xy9z7w6v5u4t"
    }
  ],
  "responses": {
    "200": {
      "description": "The setting.",
      "headers": {
        "X-RateLimit-Tier": {
          "description": "Rate-limit tier of the key: personal, app or first_party (first_party is unlimited).",
          "schema": {
            "type": "string",
            "enum": [
              "personal",
              "app",
              "first_party"
            ]
          }
        },
        "X-RateLimit-Limit": {
          "description": "Requests allowed per minute for this key (absent on first_party).",
          "schema": {
            "type": "integer"
          }
        },
        "X-RateLimit-Remaining": {
          "description": "Requests left in the current minute window.",
          "schema": {
            "type": "integer"
          }
        },
        "X-RateLimit-Reset": {
          "description": "Epoch seconds when the minute window resets.",
          "schema": {
            "type": "integer"
          }
        },
        "X-RateLimit-Limit-Day": {
          "description": "Requests allowed per UTC day for this key (absent on first_party).",
          "schema": {
            "type": "integer"
          }
        },
        "X-RateLimit-Remaining-Day": {
          "description": "Requests left in the current UTC day window.",
          "schema": {
            "type": "integer"
          }
        },
        "X-RateLimit-Reset-Day": {
          "description": "Epoch seconds when the day window resets.",
          "schema": {
            "type": "integer"
          }
        },
        "X-Dropfans-Account": {
          "description": "The id of the account this request acted on — the key’s own account, or the managed account named in the X-Dropfans-Account request header. Assert it when acting for several accounts.",
          "schema": {
            "type": "string"
          }
        }
      },
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "account": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "The account asked about, or null for the creator’s setting."
              },
              "mode": {
                "type": "string",
                "description": "Who may chat: everyone, fans who paid (tip or drop) or subscribed, or subscribers only.",
                "enum": [
                  "EVERYONE",
                  "PAY",
                  "SUB"
                ]
              },
              "payScope": {
                "type": "string",
                "description": "Pay to Chat: `ONCE` = paid once, open for good; `PER_CONVERSATION` = a conversation can be ended and the fan pays again.",
                "enum": [
                  "ONCE",
                  "PER_CONVERSATION"
                ]
              },
              "source": {
                "type": "string",
                "description": "`account`: that Telegram account has its own setting; `creator`: the creator’s applies.",
                "enum": [
                  "account",
                  "creator"
                ]
              },
              "tier": {
                "type": [
                  "object",
                  "null"
                ],
                "properties": {
                  "priceUsd": {
                    "type": "number",
                    "description": "Price per interval, USD."
                  },
                  "interval": {
                    "type": "string",
                    "description": "Billing interval."
                  }
                },
                "required": [
                  "priceUsd",
                  "interval"
                ],
                "description": "The subscription Sub to Chat sells; null when none is on sale (Sub to Chat then asks nobody)."
              },
              "chatbots": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "account": {
                      "type": "string",
                      "description": "Telegram user id of the account."
                    },
                    "app": {
                      "type": "string",
                      "description": "The app whose bot it is."
                    },
                    "botUsername": {
                      "type": [
                        "string",
                        "null"
                      ],
                      "description": "The bot’s username, if reported."
                    },
                    "enabled": {
                      "type": "boolean",
                      "description": "Still the account’s chatbot."
                    },
                    "canReply": {
                      "type": "boolean",
                      "description": "Allowed to reply to messages."
                    },
                    "updatedAt": {
                      "type": "string",
                      "description": "Last report.",
                      "format": "date-time"
                    }
                  },
                  "required": [
                    "account",
                    "app",
                    "botUsername",
                    "enabled",
                    "canReply",
                    "updatedAt"
                  ],
                  "description": "One account’s chatbot."
                },
                "description": "Chatbots reported on the creator’s accounts: ours (app `Dropfans`) and partner apps’."
              },
              "accountSettings": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "account": {
                      "type": "string",
                      "description": "Telegram user id."
                    },
                    "mode": {
                      "type": "string",
                      "description": "Who may chat: everyone, fans who paid (tip or drop) or subscribed, or subscribers only.",
                      "enum": [
                        "EVERYONE",
                        "PAY",
                        "SUB"
                      ]
                    },
                    "payScope": {
                      "type": "string",
                      "description": "Pay to Chat: `ONCE` = paid once, open for good; `PER_CONVERSATION` = a conversation can be ended and the fan pays again.",
                      "enum": [
                        "ONCE",
                        "PER_CONVERSATION"
                      ]
                    }
                  },
                  "required": [
                    "account",
                    "mode",
                    "payScope"
                  ],
                  "description": "One account’s own setting."
                },
                "description": "Accounts with their own setting."
              }
            },
            "required": [
              "account",
              "mode",
              "payScope",
              "source",
              "tier",
              "chatbots",
              "accountSettings"
            ]
          },
          "example": {
            "account": null,
            "mode": "PAY",
            "payScope": "ONCE",
            "source": "creator",
            "tier": {
              "priceUsd": 14.99,
              "interval": "month"
            },
            "chatbots": [
              {
                "account": "5550001111",
                "app": "Your CRM",
                "botUsername": "your_bot",
                "enabled": true,
                "canReply": true,
                "updatedAt": "2026-11-12T10:00:00.000Z"
              }
            ],
            "accountSettings": [
              {
                "account": "5550002222",
                "mode": "SUB",
                "payScope": "ONCE"
              }
            ]
          }
        }
      }
    },
    "400": {
      "description": "`account` is missing or not a Telegram user id. Also: `X-Dropfans-Account` is not an account id. Also: Called under /v1/creators/{creatorId}/ with an `X-Dropfans-Account` naming another account.",
      "headers": {
        "X-RateLimit-Tier": {
          "description": "Rate-limit tier of the key: personal, app or first_party (first_party is unlimited).",
          "schema": {
            "type": "string",
            "enum": [
              "personal",
              "app",
              "first_party"
            ]
          }
        },
        "X-RateLimit-Limit": {
          "description": "Requests allowed per minute for this key (absent on first_party).",
          "schema": {
            "type": "integer"
          }
        },
        "X-RateLimit-Remaining": {
          "description": "Requests left in the current minute window.",
          "schema": {
            "type": "integer"
          }
        },
        "X-RateLimit-Reset": {
          "description": "Epoch seconds when the minute window resets.",
          "schema": {
            "type": "integer"
          }
        },
        "X-RateLimit-Limit-Day": {
          "description": "Requests allowed per UTC day for this key (absent on first_party).",
          "schema": {
            "type": "integer"
          }
        },
        "X-RateLimit-Remaining-Day": {
          "description": "Requests left in the current UTC day window.",
          "schema": {
            "type": "integer"
          }
        },
        "X-RateLimit-Reset-Day": {
          "description": "Epoch seconds when the day window resets.",
          "schema": {
            "type": "integer"
          }
        }
      },
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "Human-readable message.",
                "example": "Rate limit exceeded"
              },
              "code": {
                "type": "string",
                "description": "Machine-readable code: unauthorized, app_suspended, first_party_only, api_category_disabled, rate_limited, username_required, invalid_account_header, account_not_managed, permission_denied, account_header_not_allowed, agency_key_required — plus endpoint-specific codes listed on each reference page.",
                "example": "rate_limited"
              }
            },
            "required": [
              "error",
              "code"
            ]
          },
          "example": {
            "error": "account must be a Telegram user id (digits, as a string)",
            "code": "invalid_telegram_id"
          }
        }
      }
    },
    "401": {
      "description": "Missing or invalid API key.",
      "headers": {
        "X-RateLimit-Tier": {
          "description": "Rate-limit tier of the key: personal, app or first_party (first_party is unlimited).",
          "schema": {
            "type": "string",
            "enum": [
              "personal",
              "app",
              "first_party"
            ]
          }
        },
        "X-RateLimit-Limit": {
          "description": "Requests allowed per minute for this key (absent on first_party).",
          "schema": {
            "type": "integer"
          }
        },
        "X-RateLimit-Remaining": {
          "description": "Requests left in the current minute window.",
          "schema": {
            "type": "integer"
          }
        },
        "X-RateLimit-Reset": {
          "description": "Epoch seconds when the minute window resets.",
          "schema": {
            "type": "integer"
          }
        },
        "X-RateLimit-Limit-Day": {
          "description": "Requests allowed per UTC day for this key (absent on first_party).",
          "schema": {
            "type": "integer"
          }
        },
        "X-RateLimit-Remaining-Day": {
          "description": "Requests left in the current UTC day window.",
          "schema": {
            "type": "integer"
          }
        },
        "X-RateLimit-Reset-Day": {
          "description": "Epoch seconds when the day window resets.",
          "schema": {
            "type": "integer"
          }
        }
      },
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "Human-readable message.",
                "example": "Rate limit exceeded"
              },
              "code": {
                "type": "string",
                "description": "Machine-readable code: unauthorized, app_suspended, first_party_only, api_category_disabled, rate_limited, username_required, invalid_account_header, account_not_managed, permission_denied, account_header_not_allowed, agency_key_required — plus endpoint-specific codes listed on each reference page.",
                "example": "rate_limited"
              }
            },
            "required": [
              "error",
              "code"
            ]
          },
          "example": {
            "error": "Unauthorized",
            "code": "unauthorized"
          }
        }
      }
    },
    "403": {
      "description": "A personal key: the chat gate answers back through app webhooks. Also: The creator in the path (or `X-Dropfans-Account`) is one this key cannot act for: no ACCEPTED management by your agency and not an account your app onboarded (or it no longer holds a key bound to your app), a key minted for one creator, or someone is suspended, banned or deleted. An unknown id gets the same answer. Also: For a managed creator: the agency lacks `canManageDrops` on that account. Also: Your app has the Pay to Chat [API category](https://www.dropfans.io/developers/concepts/api-categories.md) switched off (the default for new apps).",
      "headers": {
        "X-RateLimit-Tier": {
          "description": "Rate-limit tier of the key: personal, app or first_party (first_party is unlimited).",
          "schema": {
            "type": "string",
            "enum": [
              "personal",
              "app",
              "first_party"
            ]
          }
        },
        "X-RateLimit-Limit": {
          "description": "Requests allowed per minute for this key (absent on first_party).",
          "schema": {
            "type": "integer"
          }
        },
        "X-RateLimit-Remaining": {
          "description": "Requests left in the current minute window.",
          "schema": {
            "type": "integer"
          }
        },
        "X-RateLimit-Reset": {
          "description": "Epoch seconds when the minute window resets.",
          "schema": {
            "type": "integer"
          }
        },
        "X-RateLimit-Limit-Day": {
          "description": "Requests allowed per UTC day for this key (absent on first_party).",
          "schema": {
            "type": "integer"
          }
        },
        "X-RateLimit-Remaining-Day": {
          "description": "Requests left in the current UTC day window.",
          "schema": {
            "type": "integer"
          }
        },
        "X-RateLimit-Reset-Day": {
          "description": "Epoch seconds when the day window resets.",
          "schema": {
            "type": "integer"
          }
        }
      },
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "Human-readable message.",
                "example": "Rate limit exceeded"
              },
              "code": {
                "type": "string",
                "description": "Machine-readable code: unauthorized, app_suspended, first_party_only, api_category_disabled, rate_limited, username_required, invalid_account_header, account_not_managed, permission_denied, account_header_not_allowed, agency_key_required — plus endpoint-specific codes listed on each reference page.",
                "example": "rate_limited"
              }
            },
            "required": [
              "error",
              "code"
            ]
          },
          "example": {
            "error": "This endpoint needs a key bound to an app with the chat_gate API category enabled — personal keys cannot use it.",
            "code": "app_key_required",
            "category": "chat_gate"
          }
        }
      }
    },
    "409": {
      "description": "The account is a fan account, suspended or banned.",
      "headers": {
        "X-RateLimit-Tier": {
          "description": "Rate-limit tier of the key: personal, app or first_party (first_party is unlimited).",
          "schema": {
            "type": "string",
            "enum": [
              "personal",
              "app",
              "first_party"
            ]
          }
        },
        "X-RateLimit-Limit": {
          "description": "Requests allowed per minute for this key (absent on first_party).",
          "schema": {
            "type": "integer"
          }
        },
        "X-RateLimit-Remaining": {
          "description": "Requests left in the current minute window.",
          "schema": {
            "type": "integer"
          }
        },
        "X-RateLimit-Reset": {
          "description": "Epoch seconds when the minute window resets.",
          "schema": {
            "type": "integer"
          }
        },
        "X-RateLimit-Limit-Day": {
          "description": "Requests allowed per UTC day for this key (absent on first_party).",
          "schema": {
            "type": "integer"
          }
        },
        "X-RateLimit-Remaining-Day": {
          "description": "Requests left in the current UTC day window.",
          "schema": {
            "type": "integer"
          }
        },
        "X-RateLimit-Reset-Day": {
          "description": "Epoch seconds when the day window resets.",
          "schema": {
            "type": "integer"
          }
        }
      },
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "Human-readable message.",
                "example": "Rate limit exceeded"
              },
              "code": {
                "type": "string",
                "description": "Machine-readable code: unauthorized, app_suspended, first_party_only, api_category_disabled, rate_limited, username_required, invalid_account_header, account_not_managed, permission_denied, account_header_not_allowed, agency_key_required — plus endpoint-specific codes listed on each reference page.",
                "example": "rate_limited"
              }
            },
            "required": [
              "error",
              "code"
            ]
          },
          "example": {
            "error": "The chat gate is for creator accounts.",
            "code": "not_a_creator"
          }
        }
      }
    },
    "429": {
      "description": "Rate limit exceeded for the current minute or day window. Wait Retry-After seconds and retry.",
      "headers": {
        "X-RateLimit-Tier": {
          "description": "Rate-limit tier of the key: personal, app or first_party (first_party is unlimited).",
          "schema": {
            "type": "string",
            "enum": [
              "personal",
              "app",
              "first_party"
            ]
          }
        },
        "X-RateLimit-Limit": {
          "description": "Requests allowed per minute for this key (absent on first_party).",
          "schema": {
            "type": "integer"
          }
        },
        "X-RateLimit-Remaining": {
          "description": "Requests left in the current minute window.",
          "schema": {
            "type": "integer"
          }
        },
        "X-RateLimit-Reset": {
          "description": "Epoch seconds when the minute window resets.",
          "schema": {
            "type": "integer"
          }
        },
        "X-RateLimit-Limit-Day": {
          "description": "Requests allowed per UTC day for this key (absent on first_party).",
          "schema": {
            "type": "integer"
          }
        },
        "X-RateLimit-Remaining-Day": {
          "description": "Requests left in the current UTC day window.",
          "schema": {
            "type": "integer"
          }
        },
        "X-RateLimit-Reset-Day": {
          "description": "Epoch seconds when the day window resets.",
          "schema": {
            "type": "integer"
          }
        },
        "Retry-After": {
          "description": "Seconds to wait before retrying (sent with 429s).",
          "schema": {
            "type": "integer"
          }
        }
      },
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "Human-readable message.",
                "example": "Rate limit exceeded"
              },
              "code": {
                "type": "string",
                "description": "Machine-readable code: unauthorized, app_suspended, first_party_only, api_category_disabled, rate_limited, username_required, invalid_account_header, account_not_managed, permission_denied, account_header_not_allowed, agency_key_required — plus endpoint-specific codes listed on each reference page.",
                "example": "rate_limited"
              }
            },
            "required": [
              "error",
              "code"
            ]
          },
          "example": {
            "error": "Rate limit exceeded",
            "code": "rate_limited"
          }
        }
      }
    },
    "503": {
      "description": "Something failed on our side. Fail open: let the message stand.",
      "headers": {
        "X-RateLimit-Tier": {
          "description": "Rate-limit tier of the key: personal, app or first_party (first_party is unlimited).",
          "schema": {
            "type": "string",
            "enum": [
              "personal",
              "app",
              "first_party"
            ]
          }
        },
        "X-RateLimit-Limit": {
          "description": "Requests allowed per minute for this key (absent on first_party).",
          "schema": {
            "type": "integer"
          }
        },
        "X-RateLimit-Remaining": {
          "description": "Requests left in the current minute window.",
          "schema": {
            "type": "integer"
          }
        },
        "X-RateLimit-Reset": {
          "description": "Epoch seconds when the minute window resets.",
          "schema": {
            "type": "integer"
          }
        },
        "X-RateLimit-Limit-Day": {
          "description": "Requests allowed per UTC day for this key (absent on first_party).",
          "schema": {
            "type": "integer"
          }
        },
        "X-RateLimit-Remaining-Day": {
          "description": "Requests left in the current UTC day window.",
          "schema": {
            "type": "integer"
          }
        },
        "X-RateLimit-Reset-Day": {
          "description": "Epoch seconds when the day window resets.",
          "schema": {
            "type": "integer"
          }
        }
      },
      "content": {
        "application/json": {
          "schema": {
            "type": "object",
            "properties": {
              "error": {
                "type": "string",
                "description": "Human-readable message.",
                "example": "Rate limit exceeded"
              },
              "code": {
                "type": "string",
                "description": "Machine-readable code: unauthorized, app_suspended, first_party_only, api_category_disabled, rate_limited, username_required, invalid_account_header, account_not_managed, permission_denied, account_header_not_allowed, agency_key_required — plus endpoint-specific codes listed on each reference page.",
                "example": "rate_limited"
              }
            },
            "required": [
              "error",
              "code"
            ]
          },
          "example": {
            "error": "The chat gate is not available right now. Let the message through.",
            "code": "unavailable"
          }
        }
      }
    }
  },
  "x-codeSamples": [
    {
      "lang": "cURL",
      "label": "curl",
      "source": "curl \"https://www.dropfans.io/api/external/v1/chat-gate?account=5550001111\" \\\n  -H \"Authorization: Bearer $DROPFANS_API_KEY\""
    },
    {
      "lang": "JavaScript",
      "label": "Node",
      "source": "const res = await fetch(`https://www.dropfans.io/api/external/v1/chat-gate?account=5550001111`, {\n  headers: {\n    Authorization: `Bearer ${process.env.DROPFANS_API_KEY}`,\n  },\n});\nconsole.log(await res.json());"
    },
    {
      "lang": "Python",
      "source": "import os\nimport requests\n\nres = requests.get(\n    \"https://www.dropfans.io/api/external/v1/chat-gate\",\n    headers={\"Authorization\": f\"Bearer {os.environ['DROPFANS_API_KEY']}\"},\n    params={\"account\": \"5550001111\"},\n)\nprint(res.json())"
    }
  ],
  "x-dropfans-docs": "https://www.dropfans.io/developers/reference/get-chat-gate",
  "x-dropfans-category": "chat_gate",
  "x-dropfans-agency-permission": "canManageDrops"
}
```

---

Previous: [Send a test webhook event for your app](https://www.dropfans.io/developers/reference/test-webhook.md) · Next: [Change the Pay to Chat setting](https://www.dropfans.io/developers/reference/update-chat-gate.md) · All pages: [llms.txt](https://www.dropfans.io/developers/llms.txt)
