> ## Documentation Index > Fetch the complete documentation index at: https://docs.wavix.com/llms.txt > Use this file to discover all available pages before exploring further. # List SIP trunks > Returns a paginated list of SIP trunks for the authenticated account. ## OpenAPI ````yaml https://wavix.github.io/wavix-openapi/wavix-api.yaml get /v1/trunks openapi: 3.1.0 info: title: Wavix APIs description: >- Wavix provides robust APIs that let you integrate voice and text messaging features directly into your app. Send text, place calls, and access detailed reports programmatically. termsOfService: https://wavix.com/terms-and-conditions license: name: MIT identifier: MIT contact: name: Wavix url: https://wavix.com email: support@wavix.com version: '1.0' servers: - url: https://api.wavix.com description: https://api.wavix.com variables: {} security: - bearerAuth: [] tags: - name: SIP trunks description: SIP trunks - name: Buy description: Numbers - name: Cart description: Numbers - name: My numbers description: Numbers - name: Billing description: Billing, transactions, and invoices - name: Profile description: Account profile and customer information - name: CDRs description: Call detail records and call history - name: Speech Analytics description: Call transcription and speech analytics - name: SMS and MMS description: Messaging - name: Number Validator description: Phone number validation - name: Link shortener description: Short link and click metrics - name: 2FA description: Two-factor authentication - name: 10DLC description: 10DLC Campaigns and Brands - name: API Keys description: API key management - name: Call webhooks description: Webhook configuration for call events - name: Call control description: Programmable Voice - name: Call streaming description: Real-time call audio streaming over WebSocket - name: Call recording description: Call recording - name: Sub-accounts description: Sub-account management - name: Voice campaigns description: Outbound voice campaigns - name: Wavix Embeddable description: WebRTC embeddable widget paths: /v1/trunks: get: tags: - SIP trunks summary: List SIP trunks description: Returns a paginated list of SIP trunks for the authenticated account. operationId: sip_trunks_list parameters: - name: page in: query description: Page number to retrieve. Default `1`. style: form schema: type: integer format: int32 - name: per_page in: query description: Number of records to return per page. Default `25`. style: form schema: type: integer format: int32 responses: '200': description: Returns a paginated list of SIP trunks. headers: {} content: application/json: schema: allOf: - $ref: '#/components/schemas/SIPTrunkListResponse' examples: success: summary: Successful response value: sip_trunks: - id: 3107 label: My trunk name: '32882' auth_method: IP auth callerid: '14302287001' host_request: host: 127.0.0.1 status: pending encrypted_media: false passthrough: false multiple_numbers: true status: pending charge: '24.637' talk_time: 65 machine_detection_enabled: true call_recording_enabled: true transcription_enabled: true transcription_threshold: 6 access_token: >- siped7a3f5c1b9e042d6f8a4c2e7b9d1f3a5c8e0b2d4f6a8c0e2d4b6f8a1c3e5d7 pagination: current_page: 1 total: 1 per_page: 25 total_pages: 1 '401': $ref: '#/components/responses/UnauthorizedErrorResponse' '403': $ref: '#/components/responses/ForbiddenErrorResponse' deprecated: false security: - bearerAuth: - trunks:read components: schemas: SIPTrunkListResponse: title: SIPTrunkListResponse required: - sip_trunks - pagination type: object additionalProperties: false properties: sip_trunks: type: - array - 'null' items: $ref: '#/components/schemas/SIPTrunkSummary' description: SIP trunks associated with the account. pagination: $ref: '#/components/schemas/Pagination' example: sip_trunks: - id: 3107 label: My trunk name: '32882' auth_method: IP auth callerid: '14302287001' host_request: host: 127.0.0.1 status: pending encrypted_media: false passthrough: false multiple_numbers: true status: pending charge: '24.637' talk_time: 65 machine_detection_enabled: true call_recording_enabled: true transcription_enabled: true transcription_threshold: 6 access_token: siped7a3f5c1b9e042d6f8a4c2e7b9d1f3a5c8e0b2d4f6a8c0e2d4b6f8a1c3e5d7 pagination: current_page: 1 total: 1 per_page: 25 total_pages: 1 SIPTrunkSummary: title: SIPTrunkSummary required: - id - name - callerid - multiple_numbers - label - auth_method - host_request - status - talk_time - charge - access_token type: object additionalProperties: false properties: id: type: integer description: Unique identifier of the SIP trunk on the platform format: int32 example: 293 name: type: string description: System-generated login name of the SIP trunk example: '67758' callerid: type: - string - 'null' description: >- Caller ID associated with the SIP trunk. Contains `null` if no Caller ID is set, or an empty string if multiple Caller IDs are allowed. example: '12345678900' label: type: string description: User-defined name of the SIP trunk example: My trunk auth_method: description: >- SIP trunk authentication method. Can be either `Digest` or `IP auth`. type: string host_request: type: - object - 'null' description: >- For SIP trunks with IP-based authentication, contains the status of the IP authentication request. properties: host: type: string description: The IP address submitted for authentication example: 127.0.0.1 status: type: string description: Status of the IP authentication request example: pending passthrough: type: boolean description: Indicates whether Caller ID passthrough is enabled for the SIP trunk example: false multiple_numbers: type: boolean description: Indicates whether multiple Caller IDs are enabled for the SIP trunk example: false status: type: string description: >- Status of the SIP trunk. Possible values are: `active` - The SIP trunk is active and can be used to place outbound calls. `pending` - The IP authentication request is under review by the Wavix team. `rejected` - The IP authentication request was rejected by the Wavix team. SIP trunks with a `pending` or `rejected` status can't be used to place calls. talk_time: description: >- Total duration of all outbound calls placed through the SIP trunk the current month, in seconds. Automatically resets at the beginning of each month. type: integer format: int32 example: 65 charge: description: >- Total cost of all outbound calls placed through the SIP trunk in the current month, in USD. Automatically resets at the beginning of each month. type: string example: '24.637' call_recording_enabled: description: >- Indicates whether outbound call recording is enabled for the SIP trunk type: boolean default: false machine_detection_enabled: description: >- Indicates whether automatic voicemail detection is enabled for the SIP trunk. Available for `Flex Pro` customers only. type: boolean default: false transcription_enabled: description: >- Indicates whether automatic call transcription is enabled for the SIP trunk. Available for `Flex Pro` customers only. type: boolean default: false transcription_threshold: description: >- Minimum call duration (in seconds) required to automatically generate a transcription. Transcriptions are created for calls that meet or exceed this value. Available to `Flex Pro` customers only. type: integer format: int32 default: 6 encrypted_media: type: boolean description: >- Indicates whether SRTP media encryption is enabled for the SIP trunk. example: true access_token: type: - string - 'null' description: Static authentication token for the SIP trunk. example: siped7a3f5c1b9e042d6f8a4c2e7b9d1f3a5c8e0b2d4f6a8c0e2d4b6f8a1c3e5d7 description: A SIP trunk associated with the account. example: id: 3107 label: My trunk name: '32882' auth_method: Digest callerid: '14302287001' host_request: null passthrough: false multiple_numbers: false status: active charge: '24.637' talk_time: 65 machine_detection_enabled: true call_recording_enabled: true transcription_enabled: true transcription_threshold: 6 access_token: siped7a3f5c1b9e042d6f8a4c2e7b9d1f3a5c8e0b2d4f6a8c0e2d4b6f8a1c3e5d7 Pagination: title: Pagination required: - current_page - per_page - total - total_pages type: object additionalProperties: false properties: current_page: type: integer description: Current page number. format: int32 example: 2 per_page: type: integer description: Number of records per page. format: int32 example: 25 total: type: integer description: Total number of records. format: int32 example: 101 total_pages: type: integer description: Total number of pages. format: int32 example: 5 UnauthorizedErrorResponse: title: UnauthorizedErrorResponse type: object properties: success: type: boolean description: >- Indicates whether the request was successful. Always `false` for this error. example: false error: type: boolean description: >- Indicates that the response represents an error. Always `true` for this error. example: true message: type: string description: >- Human-readable description stating that authentication is missing or invalid. example: Unauthorized ForbiddenErrorResponse: title: ForbiddenErrorResponse type: object properties: success: type: boolean description: >- Indicates whether the request was successful. Always `false` for this error. example: false message: type: string description: Human-readable description of why access is forbidden. example: The service is not provisioned for your account. responses: UnauthorizedErrorResponse: description: Unauthorized headers: {} content: application/json: schema: $ref: '#/components/schemas/UnauthorizedErrorResponse' ForbiddenErrorResponse: description: Request failed. The feature is disabled for your account. headers: {} content: application/json: schema: $ref: '#/components/schemas/ForbiddenErrorResponse' securitySchemes: bearerAuth: type: http scheme: bearer description: > Wavix API key. Pass as `Authorization: Bearer `. Keys support per-resource scopes (none / read / write). See [Restricted keys and scopes](https://docs.wavix.com/api-reference/authentication#restricted-keys-and-scopes). ````