{
  "opencollection": "1.0.0",
  "info": {
    "name": "Telnyx Access Tokens Reputation Phone Numbers API",
    "version": "2.0.0"
  },
  "request": {
    "auth": {
      "type": "bearer",
      "token": "{{bearerToken}}"
    }
  },
  "items": [
    {
      "info": {
        "name": "Reputation Phone Numbers",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "List reputation phone numbers",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.telnyx.com/v2/enterprises/:enterprise_id/reputation/numbers",
            "params": [
              {
                "name": "enterprise_id",
                "value": "",
                "type": "path",
                "description": "Unique identifier of the enterprise (UUID)"
              },
              {
                "name": "page[number]",
                "value": "",
                "type": "query",
                "description": "Page number (1-indexed)"
              },
              {
                "name": "page[size]",
                "value": "",
                "type": "query",
                "description": "Number of items per page"
              },
              {
                "name": "phone_number",
                "value": "",
                "type": "query",
                "description": "Filter by specific phone number (E.164 format)"
              }
            ]
          },
          "docs": "List all phone numbers associated with an enterprise for Number Reputation monitoring.\n\nReturns phone numbers with their cached reputation data (if available). Supports pagination and filtering by phone number."
        },
        {
          "info": {
            "name": "Associate phone numbers for reputation",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://api.telnyx.com/v2/enterprises/:enterprise_id/reputation/numbers",
            "params": [
              {
                "name": "enterprise_id",
                "value": "",
                "type": "path",
                "description": "Unique identifier of the enterprise (UUID)"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Associate one or more phone numbers with an enterprise for Number Reputation monitoring.\n\n**Validations:**\n- Phone numbers must be in E.164 format (e.g., `+16035551234`)\n- Phone numbers must be in-service and belong to your account (verified via Warehouse)\n- Phone numbers must be US local numbers\n- Phone numbers cannot already be associated with any enterprise\n\n**Note:** This operation is atomic — if any number fails validation, the entire request fails.\n\n**Maximum:** 100 phone numbers per reque"
        },
        {
          "info": {
            "name": "Get reputation data for a phone number",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.telnyx.com/v2/enterprises/:enterprise_id/reputation/numbers/:phone_number",
            "params": [
              {
                "name": "enterprise_id",
                "value": "",
                "type": "path",
                "description": "Unique identifier of the enterprise (UUID)"
              },
              {
                "name": "phone_number",
                "value": "",
                "type": "path",
                "description": "Phone number in E.164 format"
              },
              {
                "name": "fresh",
                "value": "",
                "type": "query",
                "description": "When true, fetches fresh reputation data (incurs API cost). When false, returns cached data."
              }
            ]
          },
          "docs": "Get detailed reputation data for a specific phone number associated with an enterprise.\n\n**Query Parameters:**\n- `fresh` (default: `false`): When `true`, fetches fresh reputation data (incurs API cost). When `false`, returns cached data. If no cached data exists, fresh data is automatically fetched.\n\n**Returns:**\n- `spam_risk`: Overall spam risk level (`low`, `medium`, `high`)\n- `spam_category`: Spam category classification\n- `maturity_score`: Maturity metric (0–100)\n- `connection_score`: Connec"
        },
        {
          "info": {
            "name": "Disassociate a phone number",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "https://api.telnyx.com/v2/enterprises/:enterprise_id/reputation/numbers/:phone_number",
            "params": [
              {
                "name": "enterprise_id",
                "value": "",
                "type": "path",
                "description": "Unique identifier of the enterprise (UUID)"
              },
              {
                "name": "phone_number",
                "value": "",
                "type": "path",
                "description": "Phone number in E.164 format"
              }
            ]
          },
          "docs": "Remove a phone number from Number Reputation monitoring for an enterprise.\n\nThe number will no longer be tracked and reputation data will no longer be refreshed."
        },
        {
          "info": {
            "name": "List reputation phone numbers (simplified)",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.telnyx.com/v2/reputation/numbers",
            "params": [
              {
                "name": "page[number]",
                "value": "",
                "type": "query",
                "description": "Page number (1-indexed)"
              },
              {
                "name": "page[size]",
                "value": "",
                "type": "query",
                "description": "Number of items per page"
              },
              {
                "name": "phone_number",
                "value": "",
                "type": "query",
                "description": "Filter by specific phone number (E.164 format)"
              }
            ]
          },
          "docs": "List all phone numbers enrolled in Number Reputation monitoring for your account. This is a simplified endpoint that does not require an `enterprise_id` — it returns numbers across all your enterprises.\n\nSupports pagination and filtering by phone number."
        },
        {
          "info": {
            "name": "Get reputation data for a phone number (simplified)",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://api.telnyx.com/v2/reputation/numbers/:phone_number",
            "params": [
              {
                "name": "phone_number",
                "value": "",
                "type": "path",
                "description": "Phone number in E.164 format"
              },
              {
                "name": "fresh",
                "value": "",
                "type": "query",
                "description": "When true, fetches fresh reputation data (incurs API cost). When false, returns cached data."
              }
            ]
          },
          "docs": "Get reputation data for a specific phone number without requiring an `enterprise_id`.\n\nSame response as the enterprise-scoped endpoint. Uses cached data by default."
        },
        {
          "info": {
            "name": "Disassociate a phone number (simplified)",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "https://api.telnyx.com/v2/reputation/numbers/:phone_number",
            "params": [
              {
                "name": "phone_number",
                "value": "",
                "type": "path",
                "description": "Phone number in E.164 format"
              }
            ]
          },
          "docs": "Remove a phone number from Number Reputation monitoring without requiring an `enterprise_id`."
        }
      ]
    }
  ],
  "bundled": true
}