# Get Sender ID Verifications

Returns the collection of Sender ID verifications of the account.

## Request

HTTP Method: `GET`

URI Path: `/v3/sender_id_verifications`

Note

For all returned data attributes, see [Sender ID Verification Object](sender-id-verification-object.html).

### URI Query Parameters

| Name | Type | Is Required? | Description |
| --- | --- | --- | --- |
| include | `string` | No | [Inclusion](../../../specification/includes.html#api-includes) |
| filter[<filter\_name>] | `string` | No | [Filtering](../../../specification/filtering.html#api-filters) |
| fields[sender\_id\_verifications] | `string` | No | [Sparse fieldsets](../../../specification/sparse-fieldsets.html#api-sparse-fieldsets) |
| sort | `string` | No | [Sorting](../../../specification/sorting.html#api-sorting) |
| page[number] | `integer` | No | [Page number](../../../specification/pagination.html#api-pagination). |
| page[size] | `integer` | No | [Page size](../../../specification/pagination.html#api-pagination). Pagination defaults to `50` records per page. The maximum is `100`. |

### Includes

| Value | Description |
| --- | --- |
| sms\_trunk | [SMS Trunk Object](../sms-trunks/sms-trunk-object.html#sms-trunk-object-v35) |
| countries | [Country Object](../../coverage-resources/countries/country-object.html#country-object-v35) |
| dids | [DID Object](../did/did-object.html#did-object-v35) |
| order | [Order Object](../order/order-object.html#order-object-v35) |
| identity | [Identity Object](../../regulation-resources/identities/identity-object.html#identity-object-v35) |
| address | [Addresses Object](../../regulation-resources/addresses/address-object.html#addresses-object-v35) |

### Filters

| Filter Name | Type | Allow Blank | Allow Array | Filters by: |
| --- | --- | --- | --- | --- |
| id | `string` | No | Yes | The verification `id` field. |
| name | `string` | No | No | Verifications whose `name` field contains this value. |
| reference | `string` | No | No | The `reference` field (exact match). |
| status | `string` | No | No | The `status` field. Possible values: `active`, `changes_required`, `closed`, `closing_in_process`, `in_process`, `new`. |
| sender\_type | `string` | No | No | The `sender_type` field. Possible values: `alphanumeric`, `carrier`, `long_code`, `short_code`, `toll_free`. |
| sms\_trunk.id | `string` | No | Yes | The ID field of `sms_trunk` relationship. |

### Sorting

| Value | Sorts by: |
| --- | --- |
| name | The `name` field. |
| status | The `status` field. |
| created\_at | The `created_at` field. |
| renew\_date | The `renew_date` field. |

Prefix a value with `-` to sort in descending order.

## Examples

Simple RequestFilter by Status and Sender TypeIncluded SMS Trunk

[[DIDWW-API-EXAMPLE-START]]

http

```
1GET /v3/sender_id_verifications HTTP/1.1
2Host: api.didww.com
3Content-Type: application/vnd.api+json
4Accept: application/vnd.api+json
5Authorization: Bearer [access token]
```

curl

```
1curl -i -X GET https://api.didww.com/v3/sender_id_verifications -H "Accept: application/vnd.api+json" -H "Content-Type: application/vnd.api+json" -H "Authorization: Bearer [access token]"
```

response

```
  1HTTP/1.1 200 OK
  2Content-Type: application/vnd.api+json
  3
  4{
  5  "data": [
  6    {
  7      "id": "e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10",
  8      "type": "sender_id_verifications",
  9      "attributes": {
 10        "name": "ACME alerts",
 11        "status": "active",
 12        "sender_type": "alphanumeric",
 13        "sender_ids": [
 14          "ACME"
 15        ],
 16        "reference": "SID-1234",
 17        "reject_reasons": null,
 18        "reject_comment": null,
 19        "renew_date": "2026-11-22",
 20        "created_at": "2026-10-22T09:15:42.118Z",
 21        "activated_at": "2026-10-22T11:40:03.512Z",
 22        "closed_at": null
 23      },
 24      "relationships": {
 25        "sms_trunk": {
 26          "links": {
 27            "self": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/relationships/sms_trunk",
 28            "related": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/sms_trunk"
 29          }
 30        },
 31        "countries": {
 32          "links": {
 33            "self": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/relationships/countries",
 34            "related": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/countries"
 35          }
 36        },
 37        "dids": {
 38          "links": {
 39            "self": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/relationships/dids",
 40            "related": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/dids"
 41          }
 42        },
 43        "order": {
 44          "links": {
 45            "self": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/relationships/order",
 46            "related": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/order"
 47          }
 48        },
 49        "identity": {
 50          "links": {
 51            "self": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/relationships/identity",
 52            "related": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/identity"
 53          }
 54        },
 55        "address": {
 56          "links": {
 57            "self": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/relationships/address",
 58            "related": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/address"
 59          }
 60        }
 61      },
 62      "meta": {
 63        "setup_price": "10.0",
 64        "monthly_price": "15.0"
 65      }
 66    },
 67    {
 68      "id": "f17c3a52-8d0e-4b69-a1c7-4e92d6b03f58",
 69      "type": "sender_id_verifications",
 70      "attributes": {
 71        "name": "Support replies",
 72        "status": "changes_required",
 73        "sender_type": "long_code",
 74        "sender_ids": [
 75          "12025550123"
 76        ],
 77        "reference": "SID-1235",
 78        "reject_reasons": [
 79          "Verification outdated"
 80        ],
 81        "reject_comment": "Update the address.",
 82        "renew_date": "2026-11-22",
 83        "created_at": "2026-10-22T09:20:11.904Z",
 84        "activated_at": null,
 85        "closed_at": null
 86      },
 87      "relationships": {
 88        "sms_trunk": {
 89          "links": {
 90            "self": "https://api.didww.com/v3/sender_id_verifications/f17c3a52-8d0e-4b69-a1c7-4e92d6b03f58/relationships/sms_trunk",
 91            "related": "https://api.didww.com/v3/sender_id_verifications/f17c3a52-8d0e-4b69-a1c7-4e92d6b03f58/sms_trunk"
 92          }
 93        },
 94        "countries": {
 95          "links": {
 96            "self": "https://api.didww.com/v3/sender_id_verifications/f17c3a52-8d0e-4b69-a1c7-4e92d6b03f58/relationships/countries",
 97            "related": "https://api.didww.com/v3/sender_id_verifications/f17c3a52-8d0e-4b69-a1c7-4e92d6b03f58/countries"
 98          }
 99        },
100        "dids": {
101          "links": {
102            "self": "https://api.didww.com/v3/sender_id_verifications/f17c3a52-8d0e-4b69-a1c7-4e92d6b03f58/relationships/dids",
103            "related": "https://api.didww.com/v3/sender_id_verifications/f17c3a52-8d0e-4b69-a1c7-4e92d6b03f58/dids"
104          }
105        },
106        "order": {
107          "links": {
108            "self": "https://api.didww.com/v3/sender_id_verifications/f17c3a52-8d0e-4b69-a1c7-4e92d6b03f58/relationships/order",
109            "related": "https://api.didww.com/v3/sender_id_verifications/f17c3a52-8d0e-4b69-a1c7-4e92d6b03f58/order"
110          }
111        },
112        "identity": {
113          "links": {
114            "self": "https://api.didww.com/v3/sender_id_verifications/f17c3a52-8d0e-4b69-a1c7-4e92d6b03f58/relationships/identity",
115            "related": "https://api.didww.com/v3/sender_id_verifications/f17c3a52-8d0e-4b69-a1c7-4e92d6b03f58/identity"
116          }
117        },
118        "address": {
119          "links": {
120            "self": "https://api.didww.com/v3/sender_id_verifications/f17c3a52-8d0e-4b69-a1c7-4e92d6b03f58/relationships/address",
121            "related": "https://api.didww.com/v3/sender_id_verifications/f17c3a52-8d0e-4b69-a1c7-4e92d6b03f58/address"
122          }
123        }
124      },
125      "meta": {
126        "setup_price": "5.5",
127        "monthly_price": "2.25"
128      }
129    }
130  ],
131  "meta": {
132    "api_version": "2026-11-19",
133    "total_records": 2
134  },
135  "links": {
136    "first": "https://api.didww.com/v3/sender_id_verifications?page%5Bnumber%5D=1&page%5Bsize%5D=50",
137    "last": "https://api.didww.com/v3/sender_id_verifications?page%5Bnumber%5D=1&page%5Bsize%5D=50"
138  }
139}
```

[[DIDWW-API-EXAMPLE-END]]

[[DIDWW-API-EXAMPLE-START]]

http

```
1GET /v3/sender_id_verifications?filter%5Bstatus%5D=active&filter%5Bsender_type%5D=alphanumeric&sort=-created_at HTTP/1.1
2Host: api.didww.com
3Content-Type: application/vnd.api+json
4Accept: application/vnd.api+json
5Authorization: Bearer [access token]
```

curl

```
1curl -i -X GET 'https://api.didww.com/v3/sender_id_verifications?filter%5Bstatus%5D=active&filter%5Bsender_type%5D=alphanumeric&sort=-created_at' -H "Accept: application/vnd.api+json" -H "Content-Type: application/vnd.api+json" -H "Authorization: Bearer [access token]"
```

response

```
 1HTTP/1.1 200 OK
 2Content-Type: application/vnd.api+json
 3
 4{
 5  "data": [
 6    {
 7      "id": "e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10",
 8      "type": "sender_id_verifications",
 9      "attributes": {
10        "name": "ACME alerts",
11        "status": "active",
12        "sender_type": "alphanumeric",
13        "sender_ids": [
14          "ACME"
15        ],
16        "reference": "SID-1234",
17        "reject_reasons": null,
18        "reject_comment": null,
19        "renew_date": "2026-11-22",
20        "created_at": "2026-10-22T09:15:42.118Z",
21        "activated_at": "2026-10-22T11:40:03.512Z",
22        "closed_at": null
23      },
24      "relationships": {
25        "sms_trunk": {
26          "links": {
27            "self": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/relationships/sms_trunk",
28            "related": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/sms_trunk"
29          }
30        },
31        "countries": {
32          "links": {
33            "self": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/relationships/countries",
34            "related": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/countries"
35          }
36        },
37        "dids": {
38          "links": {
39            "self": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/relationships/dids",
40            "related": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/dids"
41          }
42        },
43        "order": {
44          "links": {
45            "self": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/relationships/order",
46            "related": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/order"
47          }
48        },
49        "identity": {
50          "links": {
51            "self": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/relationships/identity",
52            "related": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/identity"
53          }
54        },
55        "address": {
56          "links": {
57            "self": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/relationships/address",
58            "related": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/address"
59          }
60        }
61      },
62      "meta": {
63        "setup_price": "10.0",
64        "monthly_price": "15.0"
65      }
66    }
67  ],
68  "meta": {
69    "api_version": "2026-11-19",
70    "total_records": 1
71  },
72  "links": {
73    "first": "https://api.didww.com/v3/sender_id_verifications?filter%5Bsender_type%5D=alphanumeric&filter%5Bstatus%5D=active&sort=-created_at&page%5Bnumber%5D=1&page%5Bsize%5D=50",
74    "last": "https://api.didww.com/v3/sender_id_verifications?filter%5Bsender_type%5D=alphanumeric&filter%5Bstatus%5D=active&sort=-created_at&page%5Bnumber%5D=1&page%5Bsize%5D=50"
75  }
76}
```

[[DIDWW-API-EXAMPLE-END]]

[[DIDWW-API-EXAMPLE-START]]

http

```
1GET /v3/sender_id_verifications?include=sms_trunk HTTP/1.1
2Host: api.didww.com
3Content-Type: application/vnd.api+json
4Accept: application/vnd.api+json
5Authorization: Bearer [access token]
```

curl

```
1curl -i -X GET 'https://api.didww.com/v3/sender_id_verifications?include=sms_trunk' -H "Accept: application/vnd.api+json" -H "Content-Type: application/vnd.api+json" -H "Authorization: Bearer [access token]"
```

response

```
  1HTTP/1.1 200 OK
  2Content-Type: application/vnd.api+json
  3
  4{
  5  "data": [
  6    {
  7      "id": "e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10",
  8      "type": "sender_id_verifications",
  9      "attributes": {
 10        "name": "ACME alerts",
 11        "status": "active",
 12        "sender_type": "alphanumeric",
 13        "sender_ids": [
 14          "ACME"
 15        ],
 16        "reference": "SID-1234",
 17        "reject_reasons": null,
 18        "reject_comment": null,
 19        "renew_date": "2026-11-22",
 20        "created_at": "2026-10-22T09:15:42.118Z",
 21        "activated_at": "2026-10-22T11:40:03.512Z",
 22        "closed_at": null
 23      },
 24      "relationships": {
 25        "sms_trunk": {
 26          "links": {
 27            "self": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/relationships/sms_trunk",
 28            "related": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/sms_trunk"
 29          },
 30          "data": {
 31            "type": "sms_trunks",
 32            "id": "6a2d4f8b-1c3e-4b7a-9e5f-2d8c0b6a4f13"
 33          }
 34        },
 35        "countries": {
 36          "links": {
 37            "self": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/relationships/countries",
 38            "related": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/countries"
 39          }
 40        },
 41        "dids": {
 42          "links": {
 43            "self": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/relationships/dids",
 44            "related": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/dids"
 45          }
 46        },
 47        "order": {
 48          "links": {
 49            "self": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/relationships/order",
 50            "related": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/order"
 51          }
 52        },
 53        "identity": {
 54          "links": {
 55            "self": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/relationships/identity",
 56            "related": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/identity"
 57          }
 58        },
 59        "address": {
 60          "links": {
 61            "self": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/relationships/address",
 62            "related": "https://api.didww.com/v3/sender_id_verifications/e5a4e2f1-3b26-4a5c-9a0a-2f7c1f3e8d10/address"
 63          }
 64        }
 65      },
 66      "meta": {
 67        "setup_price": "10.0",
 68        "monthly_price": "15.0"
 69      }
 70    }
 71  ],
 72  "included": [
 73    {
 74      "id": "6a2d4f8b-1c3e-4b7a-9e5f-2d8c0b6a4f13",
 75      "type": "sms_trunks",
 76      "attributes": {
 77        "name": "Outbound HTTP",
 78        "external_reference_id": null,
 79        "blocked": false,
 80        "priority": null,
 81        "allow_any_did_as_source": false,
 82        "allow_in": false,
 83        "allow_out": true,
 84        "created_at": "2026-10-22T09:15:42.118Z",
 85        "updated_at": "2026-10-22T09:15:42.118Z",
 86        "configuration": {
 87          "type": "http_out",
 88          "attributes": {
 89            "callback_url": "https://example.com/sms/status",
 90            "allowed_ips": [
 91              "203.0.113.10/32"
 92            ],
 93            "auth_name": "k3v9xq2m7p",
 94            "auth_password": "w8r2c5n1zt"
 95          }
 96        }
 97      },
 98      "relationships": {
 99        "outgoing_dids": {
100          "links": {
101            "self": "https://api.didww.com/v3/sms_trunks/6a2d4f8b-1c3e-4b7a-9e5f-2d8c0b6a4f13/relationships/outgoing_dids",
102            "related": "https://api.didww.com/v3/sms_trunks/6a2d4f8b-1c3e-4b7a-9e5f-2d8c0b6a4f13/outgoing_dids"
103          }
104        },
105        "incoming_dids": {
106          "links": {
107            "self": "https://api.didww.com/v3/sms_trunks/6a2d4f8b-1c3e-4b7a-9e5f-2d8c0b6a4f13/relationships/incoming_dids",
108            "related": "https://api.didww.com/v3/sms_trunks/6a2d4f8b-1c3e-4b7a-9e5f-2d8c0b6a4f13/incoming_dids"
109          }
110        },
111        "sms_trunk_group": {
112          "links": {
113            "self": "https://api.didww.com/v3/sms_trunks/6a2d4f8b-1c3e-4b7a-9e5f-2d8c0b6a4f13/relationships/sms_trunk_group",
114            "related": "https://api.didww.com/v3/sms_trunks/6a2d4f8b-1c3e-4b7a-9e5f-2d8c0b6a4f13/sms_trunk_group"
115          }
116        },
117        "sender_id_verifications": {
118          "links": {
119            "self": "https://api.didww.com/v3/sms_trunks/6a2d4f8b-1c3e-4b7a-9e5f-2d8c0b6a4f13/relationships/sender_id_verifications",
120            "related": "https://api.didww.com/v3/sms_trunks/6a2d4f8b-1c3e-4b7a-9e5f-2d8c0b6a4f13/sender_id_verifications"
121          }
122        }
123      },
124      "meta": {
125        "host": "https://us.sms-out.didww.com/outbound_messages"
126      }
127    }
128  ],
129  "meta": {
130    "api_version": "2026-11-19",
131    "total_records": 1
132  },
133  "links": {
134    "first": "https://api.didww.com/v3/sender_id_verifications?include=sms_trunk&page%5Bnumber%5D=1&page%5Bsize%5D=50",
135    "last": "https://api.didww.com/v3/sender_id_verifications?include=sms_trunk&page%5Bnumber%5D=1&page%5Bsize%5D=50"
136  }
137}
```

[[DIDWW-API-EXAMPLE-END]]

## Other Responses

| Code | Success | Description |
| --- | --- | --- |
| 400 | No | [Bad Request](../../../specification/errors/index.html#api-bad-request) |
| 401 | No | [Unauthorized](../../authentication.html#authentication-v35) |
| 429 | No | The request budget of the account for the current window is spent (`too_many_requests`). `Retry-After` gives the number of seconds to wait. |
