from line 1
1---
2title: List Tunnel Certificates
3url: https://platform.claude.com/docs/en/api/beta/tunnels/certificates/list
4---
1# List Tunnel Certificates
52
6## List Tunnel Certificates
3**GET** `/v1/tunnels/{tunnel_id}/certificates`
74
8**get** `/v1/tunnels/{tunnel_id}/certificates`
9
105The Tunnels API is in research preview. It requires the `anthropic-beta: mcp-tunnels-2026-06-22` header and may change without a deprecation period. It supersedes the Admin API endpoints at `/v1/organizations/tunnels`, which remain available during a migration window.
116
127Lists the certificates registered on a tunnel. Archived certificates are excluded unless include_archived is set.
138
14### Path Parameters
9## Path parameters
1510
1611- `tunnel_id: string`
1712
18### Query Parameters
13## Query parameters
1914
2015- `include_archived: optional boolean`
2116
from line 20
2520
2621 Maximum number of certificates to return per page. Defaults to 20, maximum 1000.
2722
23 format: int32
24
2825- `page: optional string`
2926
3027 Opaque pagination cursor from a previous `list_tunnel_certificates` response.
3128
32### Header Parameters
29## Headers
3330
3431- `"anthropic-beta": optional array of AnthropicBeta`
3532
from line 104
107104
108105 - `"mid-conversation-tool-changes-2026-07-01"`
109106
110### Returns
107## Returns
111108
112109- `data: array of BetaTunnelCertificate`
113110
from line 118
121118
122119 A timestamp in RFC 3339 format
123120
121 format: date-time
122
124123 - `created_at: string`
125124
126125 A timestamp in RFC 3339 format
127126
127 format: date-time
128
128129 - `expires_at: string or null`
129130
130131 A timestamp in RFC 3339 format
131132
133 format: date-time
134
132135 - `fingerprint: string`
133136
134137 Lowercase hex SHA-256 fingerprint of the certificate's DER encoding.
from line 142
139142
140143 - `type: "tunnel_certificate"`
141144
142 - `"tunnel_certificate"`
143
144145- `next_page: string or null`
145146
146147 Pagination cursor for the next page, or null if no more results.
147148
148### Example
149## Example
149150
150```http
151```bash
151152curl https://api.anthropic.com/v1/tunnels/$TUNNEL_ID/certificates \
152153 -H 'anthropic-version: 2023-06-01' \
153154 -H 'anthropic-beta: mcp-tunnels-2026-06-22' \
from line 155
154155 -H "X-Api-Key: $ANTHROPIC_API_KEY"
155156```
156157
157#### Response
158### Response (200)
158159
159160```json
160161{
No line in this hunk matches that.