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

# Carrier Accounts Status

> Whether this workspace may use carrier accounts (calls from numbers in your own
Telnyx account). They are available in every workspace, so this answers
`{"enabled": true}` unless Yappr has switched them off for this one; then every
carrier-accounts route answers `403 CARRIER_ACCOUNTS_NOT_ENABLED`. Requires
`carrier_accounts:read`.


Whether this workspace may use carrier accounts: calls from the numbers you own in
your own Telnyx account. They are available in every workspace, so this answers
`{ "enabled": true }` unless Yappr has switched them off for yours. Requires
`carrier_accounts:read`.

```bash theme={null}
curl https://api.goyappr.com/carrier-accounts/status \
  -H "Authorization: Bearer ypr_live_..."
```

Available (every workspace):

```json theme={null}
{ "enabled": true }
```

Switched off (`403`), only where Yappr has had to turn carrier accounts off for this
workspace. Every other carrier-accounts route answers the same while it is off, and
nothing is sent to Telnyx:

```json theme={null}
{
  "error": "Calling out through your own Telnyx account is switched off for this workspace. Contact Yappr support.",
  "code": "CARRIER_ACCOUNTS_NOT_ENABLED",
  "enabled": false
}
```

## Errors

| Status | `code`                         | Meaning                                                                            |
| ------ | ------------------------------ | ---------------------------------------------------------------------------------- |
| 403    | `CARRIER_ACCOUNTS_NOT_ENABLED` | Yappr has switched carrier accounts off for this workspace. Contact Yappr support. |


## OpenAPI

````yaml GET /carrier-accounts/status
openapi: 3.1.0
info:
  title: Yappr API
  description: >
    Create and manage AI voice agents, purchase phone numbers, configure tools,
    and initiate calls — all via REST.
  version: 1.0.0
  contact:
    url: https://goyappr.com
servers:
  - url: https://api.goyappr.com
    description: Production
security:
  - apiKey: []
paths:
  /carrier-accounts/status:
    get:
      tags:
        - Carrier Accounts
      summary: Check carrier accounts are available
      description: >
        Whether this workspace may use carrier accounts (calls from numbers in
        your own

        Telnyx account). They are available in every workspace, so this answers

        `{"enabled": true}` unless Yappr has switched them off for this one;
        then every

        carrier-accounts route answers `403 CARRIER_ACCOUNTS_NOT_ENABLED`.
        Requires

        `carrier_accounts:read`.
      operationId: getCarrierAccountsStatus
      responses:
        '200':
          description: Available
          content:
            application/json:
              schema:
                type: object
                properties:
                  enabled:
                    type: boolean
                    example: true
        '403':
          $ref: '#/components/responses/CarrierAccountsNotEnabled'
components:
  responses:
    CarrierAccountsNotEnabled:
      description: >
        `CARRIER_ACCOUNTS_NOT_ENABLED` — Yappr has switched calling out through
        your own

        Telnyx account off for this workspace. It is available in every
        workspace, so this

        is only the emergency-off answer; contact Yappr support. Every
        carrier-accounts

        route answers this while it is off (check with

        [GET /carrier-accounts/status](/api-reference/carrier-accounts/status)).
        An API key

        without the route's scope gets a 403 of its own.
      content:
        application/json:
          schema:
            allOf:
              - $ref: '#/components/schemas/Error'
              - type: object
                properties:
                  enabled:
                    type: boolean
                    example: false
          example:
            error: >-
              Calling out through your own Telnyx account is switched off for
              this workspace. Contact Yappr support.
            code: CARRIER_ACCOUNTS_NOT_ENABLED
            enabled: false
  schemas:
    Error:
      type: object
      properties:
        error:
          type: string
        code:
          type: string
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      bearerFormat: API Key
      description: >-
        Your Yappr API key (e.g. `ypr_live_...`). Generate one in the dashboard
        under **Settings → API Keys**.

````