List bindings

Returns your account's bindings, newest first and paginated. Narrow the list with the optional filters — most usefully configuration_id to find every ingress point a configuration governs before you change or retire it. Follow next_cursor to page.

Required scope: intelligence:read

Query Parameters
  • cursor
    Type: string · Cursornullable

    Pagination cursor from a previous response's next_cursor. Omit for the first page.

  • limit
    Type: integer · Limit
    min:  
    1
    max:  
    100

    Maximum number of items to return (1–100, default 20).

  • configuration_id
    Type: string · Configuration Idnullable

    Only bindings for this configuration uuid.

  • medium
    Type: string · Mediumnullable

    Only bindings on this ingress plane, e.g. voice.

  • type
    Type: string · Typenullable

    Only bindings of this ingress kind, e.g. trunk or number.

  • target_status
    Type: string · Target Statusenumnullable

    Only bindings whose target is active or missing.

    values
    • active
    • missing
  • enabled
    Type: boolean · Enablednullable

    Only enabled (true) or parked (false) bindings.

  • key
    Type: string · Keynullable

    Only the binding for this exact target key (use with type).

Responses
  • application/json
  • application/json
  • application/json
Request Example for get/bindings
curl https://api.simwood.com/intelligence/v1/bindings \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "items": [
    {
      "uuid": "string",
      "configuration_id": "string",
      "target": {
        "medium": "voice",
        "type": "string",
        "key": "string"
      },
      "enabled": true,
      "target_status": "active",
      "sync_state": "live",
      "created_at": "string",
      "updated_at": "string"
    }
  ],
  "next_cursor": "string"
}