> ## Documentation Index > Fetch the complete documentation index at: https://docs.revdesk.com/llms.txt > Use this file to discover all available pages before exploring further. # List authoritative number-health evidence > Returns every phone number in the workspace with Number Set membership, provider scores, carrier-specific handset observations, evidence freshness, and the next recommended action. ## OpenAPI ````yaml /openapi.json get /v1/number-health/numbers openapi: 3.1.0 info: title: RevDesk v1 API version: 1.0.0 description: >- Connect RevDesk calls, SMS, phone numbers, caller IDs, caller trust, agents, contacts, tasks, webhooks, and usage to the rest of your revenue workflow with organization-scoped permissions. contact: name: RevDesk email: support@revdesk.com servers: - url: https://api.revdesk.com security: - bearerAuth: [] tags: - name: Phone Numbers - name: Caller IDs - name: Enterprise Registration - name: Branded Calling - name: Calls - name: SMS - name: WebRTC - name: Reputation - name: Usage - name: Account - name: Agents - name: Appointments - name: Contacts - name: Documents - name: Notifications - name: Number Health - name: Number Registration - name: Sandbox - name: Sub-entities - name: Tasks - name: Webhooks externalDocs: description: RevDesk API versioning and deprecation policy url: https://docs.revdesk.com/api-reference/versioning-and-deprecation paths: /v1/number-health/numbers: get: tags: - Number Health summary: List authoritative number-health evidence description: >- Returns every phone number in the workspace with Number Set membership, provider scores, carrier-specific handset observations, evidence freshness, and the next recommended action. operationId: v1_number_health_numbers_get parameters: - name: state in: query required: false schema: type: string enum: - CLEAN_OBSERVED - NEEDS_DATA - WATCH - FLAGGED - SETUP_INCOMPLETE - RETIRED - name: team_id in: query required: false schema: type: string format: uuid pattern: >- ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$ - name: number_set_id in: query required: false schema: type: string - name: area_code in: query required: false schema: type: string pattern: ^\d{3}$ responses: '200': description: Success headers: RateLimit: $ref: '#/components/headers/RateLimit' RateLimit-Policy: $ref: '#/components/headers/RateLimitPolicy' X-RateLimit-Limit: $ref: '#/components/headers/XRateLimitLimit' X-RateLimit-Remaining: $ref: '#/components/headers/XRateLimitRemaining' X-RateLimit-Reset: $ref: '#/components/headers/XRateLimitReset' content: application/json: schema: type: object properties: data: type: array items: type: object properties: id: type: integer minimum: -9007199254740991 maximum: 9007199254740991 phone_number: type: string name: type: - string - 'null' is_active: type: boolean team_id: type: - string - 'null' team_name: type: - string - 'null' area_code: type: string cnam_display_name: type: - string - 'null' cnam_status: type: - string - 'null' caller_registry_status: type: - string - 'null' reputation_enrolled_at: anyOf: - type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$ - type: 'null' number_set_id: type: - string - 'null' number_set_name: type: - string - 'null' number_set_use_case: type: - string - 'null' member_role: anyOf: - type: string enum: - PRIMARY - ALTERNATE - type: 'null' member_state: anyOf: - type: string enum: - PREPARING - ACTIVE - STANDBY - RETIRED - type: 'null' evidence_state: type: string enum: - CLEAN_OBSERVED - NEEDS_DATA - WATCH - FLAGGED - SETUP_INCOMPLETE - RETIRED health_warning: type: - string - 'null' recommended_action: type: string has_alternate: type: boolean spam_risk: anyOf: - type: string enum: - LOW - MEDIUM - HIGH - type: 'null' spam_category: type: - string - 'null' maturity_score: type: - number - 'null' connection_score: type: - number - 'null' engagement_score: type: - number - 'null' sentiment_score: type: - number - 'null' reputation_refreshed_at: anyOf: - type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$ - type: 'null' qualifying_calls: type: integer minimum: -9007199254740991 maximum: 9007199254740991 callback_verified: type: boolean observations: type: array items: type: object properties: id: type: string carrier: type: string enum: - ATT - TMOBILE - VERIZON - OTHER - UNKNOWN outcome: anyOf: - type: string enum: - CLEAN - NUMBER_ONLY - LOCATION - SPAM - SCAM - BLOCKED - WRONG_NAME - NO_RING - UNKNOWN - type: 'null' observed_label: type: - string - 'null' observed_at: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$ duration_seconds: type: - number - 'null' callback_verified: type: boolean required: - id - carrier - outcome - observed_label - observed_at - duration_seconds - callback_verified additionalProperties: false required: - id - phone_number - name - is_active - team_id - team_name - area_code - cnam_display_name - cnam_status - caller_registry_status - reputation_enrolled_at - number_set_id - number_set_name - number_set_use_case - member_role - member_state - evidence_state - health_warning - recommended_action - has_alternate - spam_risk - spam_category - maturity_score - connection_score - engagement_score - sentiment_score - reputation_refreshed_at - qualifying_calls - callback_verified - observations additionalProperties: false meta: type: object properties: total_results: type: number required: - total_results additionalProperties: false required: - data - meta additionalProperties: false '400': description: Validation error content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' '401': description: Unauthorized headers: WWW-Authenticate: $ref: '#/components/headers/WWWAuthenticate' content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' '403': description: Forbidden headers: WWW-Authenticate: $ref: '#/components/headers/WWWAuthenticate' content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' '404': description: Not found content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' '409': description: Conflict (incl. idempotency conflicts) content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' '429': description: Rate limited headers: RateLimit: $ref: '#/components/headers/RateLimit' RateLimit-Policy: $ref: '#/components/headers/RateLimitPolicy' X-RateLimit-Limit: $ref: '#/components/headers/XRateLimitLimit' X-RateLimit-Remaining: $ref: '#/components/headers/XRateLimitRemaining' X-RateLimit-Reset: $ref: '#/components/headers/XRateLimitReset' Retry-After: $ref: '#/components/headers/RetryAfter' content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' components: headers: RateLimit: description: >- Current quota remaining and seconds until reset, using the IETF RateLimit structured-field syntax. schema: type: string example: '"default";r=599;t=60' RateLimitPolicy: description: Named quota policy and one-minute window. schema: type: string example: '"default";q=600;w=60' XRateLimitLimit: description: Maximum requests allowed in the current one-minute window. schema: type: integer XRateLimitRemaining: description: Requests remaining in the current window. schema: type: integer XRateLimitReset: description: Unix timestamp in milliseconds when the current window resets. schema: type: integer WWWAuthenticate: description: >- Bearer challenge with RFC 9728 protected-resource metadata and, on scope failures, the required scope. schema: type: string RetryAfter: description: Seconds to wait before retrying a rate-limited request. schema: type: integer minimum: 0 schemas: ErrorEnvelope: type: object properties: error: type: object required: - code - message properties: code: type: string message: type: string resolution_hint: type: string fields: type: object additionalProperties: type: string doc_url: type: string format: uri securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: RevDesk API key description: >- Organization-scoped RevDesk API key. Each operation declares its required permissions in x-required-scopes. x-scopes-supported: - account:read - agents:read - agents:write - bookings:read - brand:read - brand:write - caller_trust:read - caller_trust:write - calls:read - calls:write - contacts:read - contacts:write - jobs:read - jobs:write - notifications:write - phone_numbers:read - phone_numbers:write - sms:read - sms:write - sub_entities:read - sub_entities:write - tokens:mint - transcripts:read - usage:read - voice:read - voice:webrtc - voice:write - webhooks:read - webhooks:write ````