> ## Documentation Index > Fetch the complete documentation index at: https://docs.phone.wixzel.com/llms.txt > Use this file to discover all available pages before exploring further. # List sip trunks > Cursor-paginated. Requires `sip_trunks:read`. ## OpenAPI ````yaml /openapi.json get /v1/sip-trunks openapi: 3.1.0 info: title: Wixzel Phone API version: '2026-09-01' description: >- APIs for AI voice agents. One key, one balance, every voice engine. ## Authentication Send your key as `Authorization: Bearer wv_live_...`. Keys are scoped — grant only what an integration needs. There is no admin scope. ## Versioning The `/v1` prefix covers additive changes. Behavioural changes ship behind a dated `Wixzel-Version` header, and existing keys keep the behaviour they were created with. ## Money Amounts are integer **micro-USD** (1,000,000 = $1.00). Voice usage is billed per second, per token and per character, so a float dollar figure cannot represent it without disagreeing with the ledger. ## Errors Every error carries a stable `code` and a `request_id`. Match on `code`; the `message` is for humans and may change. contact: name: Wixzel Phone url: https://phone.wixzel.com servers: - url: https://api.phone.wixzel.com description: Production security: [] tags: - name: Calls description: Place calls and read what happened on them. - name: Agents description: The prompt, voice and behaviour of a caller. - name: Leads description: People to call, and data to merge into prompts. - name: Campaigns description: Call a list of leads with one agent. - name: Knowledge bases description: Facts an agent can draw on mid-call. - name: Phone numbers description: Numbers on your SIP trunks. - name: SIP trunks description: Your carrier connections. - name: Appointments description: Bookings, including ones agents make on calls. - name: Usage description: Itemised billing lines. - name: Billing description: Balance, ledger and top-ups. - name: API keys description: Create, scope and rotate keys. - name: Engines description: What the platform can serve, and what it costs. paths: /v1/sip-trunks: get: tags: - SIP trunks summary: List sip trunks description: Cursor-paginated. Requires `sip_trunks:read`. parameters: - schema: type: integer minimum: 1 maximum: 100 default: 20 description: How many records to return. required: false name: limit in: query - schema: type: string minLength: 1 maxLength: 512 description: Return records after this cursor. required: false name: starting_after in: query - schema: type: string minLength: 1 maxLength: 512 description: Return records before this cursor. required: false name: ending_before in: query responses: '200': description: A page of sip trunks content: application/json: schema: $ref: '#/components/schemas/SipTrunkList' '400': description: Invalid request content: application/json: schema: $ref: '#/components/schemas/Error' '401': description: Missing or invalid API key content: application/json: schema: $ref: '#/components/schemas/Error' '403': description: Key lacks the required scope content: application/json: schema: $ref: '#/components/schemas/Error' '429': description: Rate limited. Retry after the interval in `Retry-After`. content: application/json: schema: $ref: '#/components/schemas/Error' security: - bearerAuth: [] components: schemas: SipTrunkList: type: object properties: object: type: string enum: - list data: type: array items: $ref: '#/components/schemas/SipTrunk' has_more: type: boolean description: True when more records exist after this page. next_cursor: type: - string - 'null' description: Pass as starting_after to fetch the next page. required: - object - data - has_more - next_cursor Error: type: object properties: error: type: object properties: type: type: string enum: - invalid_request_error - authentication_error - permission_error - rate_limit_error - insufficient_credits - not_found_error - conflict_error - api_error code: type: string description: Stable machine-readable code. example: agent_not_found message: type: string description: >- Human-readable explanation. Do not match on this — match on code. param: type: string description: Which field caused the failure, when applicable. doc_url: type: string request_id: type: string description: Quote this when asking for help. example: req_01HXYZ... required: - type - code - message - request_id required: - error SipTrunk: type: object properties: id: type: string pattern: ^[0-9a-f]{24}$ example: 6a96a3ead6e886d42462dd3e object: type: string enum: - sip_trunk name: type: string host: type: string port: type: integer transport: type: string enum: - udp - tcp - tls username: type: - string - 'null' send_plus: type: boolean platform_ip: type: - string - 'null' description: >- The address calls are placed from. Allowlist it with your carrier: most authorise outbound calls by source IP, and without it the trunk looks configured while no call completes. Read from the deployment rather than written down, so it cannot go stale. Null if this install has not set it. example: 95.216.218.102 origination_uri: type: - string - 'null' description: >- Where your carrier must send INBOUND calls. Paste it into the field your provider calls the Origination URI (Twilio Elastic SIP Trunking), or the termination point / destination SIP URI — the names differ, the string does not. `platform_ip` is the outbound half: it tells the carrier to accept calls FROM us. This is the inbound half, and it is separate configuration in a different part of their console. Without it a number is bought, pointed at an agent, and simply never rings, because the carrier has nowhere to deliver the call to. Null if this install has not published a SIP address. example: sip:95.216.218.102:5090 provider_name: type: - string - 'null' status: type: string created_at: type: string format: date-time description: ISO 8601, always UTC. example: '2026-09-01T12:00:00.000Z' required: - id - object - name - host - port - transport - username - send_plus - platform_ip - origination_uri - provider_name - status - created_at securitySchemes: bearerAuth: type: http scheme: bearer description: >- Your Wixzel Phone API key: `Authorization: Bearer wv_live_...`. Keys are scoped; grant only what the integration needs. ````