# Get DID History

Returns a single DID history record from the last `90` days.

## Request

HTTP Method: `GET`

URI Path: `/v3/did_history/{id}`

Note

For all returned data attributes, see [Did History Object](did-history-object.html).

### URI Path Parameters

| Name | Type | Is Required? | Description |
| --- | --- | --- | --- |
| id | `string` | Yes | Unique ID of the DID history record. |

## Examples

Action: RemovedAction: Billing Cycles Count Changed

[[DIDWW-API-EXAMPLE-START]]

http

```
1GET /v3/did_history/9e3b65e9-fdc4-1810-9e93-b7127ab6b976 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/did_history/9e3b65e9-fdc4-1810-9e93-b7127ab6b976 -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        "id": "9e3b65e9-fdc4-1810-9e93-b7127ab6b976",
 7        "type": "did_history",
 8        "attributes": {
 9            "did_number": "437xxxxxxxxx",
10            "action": "removed",
11            "method": "api3",
12            "created_at": "2026-03-06T15:11:00.326Z"
13        }
14    },
15    "meta": {
16        "api_version": "2026-11-19"
17    }
18}
```

[[DIDWW-API-EXAMPLE-END]]

[[DIDWW-API-EXAMPLE-START]]

http

```
1GET /v3/did_history/9e3b65e9-fdc4-1810-9e93-b7127ab6b976 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/did_history/9e3b65e9-fdc4-1810-9e93-b7127ab6b976 -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        "id": "9e3b65e9-fdc4-1810-9e93-b7127ab6b976",
 7        "type": "did_history",
 8        "attributes": {
 9            "did_number": "437xxxxxxxxx",
10            "action": "billing_cycles_count_changed",
11            "method": "staff",
12            "created_at": "2026-03-06T15:11:00.326Z"
13        },
14        "meta": {
15            "from": "3",
16            "to": "5"
17        }
18    },
19    "meta": {
20        "api_version": "2026-11-19"
21    }
22}
```

[[DIDWW-API-EXAMPLE-END]]

## Other Responses

| Code | Success | Description |
| --- | --- | --- |
| 404 | No | [Not Found](../../../specification/errors/index.html#api-not-found) |
| 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. |
