# List chains

> For the complete documentation index, see [llms.txt](/docs/llms.txt).

GET https://admin-api.alchemy.com/v1/chains

Retrieves a list of all blockchain networks supported by Alchemy, including their identifiers, display names, testnet status, and availability. Use this endpoint to discover valid network values for configuring app network allowlists.

Reference: https://www.alchemy.com/docs/tutorials/tools/admin-api/admin-api-endpoints/list-chains

## Headers

| Name | Type | Required | Description |
|------|------|----------|-------------|
| Authorization | string | Yes | Bearer authentication token |

## Code Examples

### cURL

```bash
curl --request GET \
  --url https://admin-api.alchemy.com/v1/chains \
  --header 'Authorization: Bearer <token>'
```

### JavaScript

```javascript
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://admin-api.alchemy.com/v1/chains', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
```

### Python

```python
import requests

url = "https://admin-api.alchemy.com/v1/chains"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)
```

### Go

```go
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://admin-api.alchemy.com/v1/chains"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}
```

### Java

```java
HttpResponse<String> response = Unirest.get("https://admin-api.alchemy.com/v1/chains")
  .header("Authorization", "Bearer <token>")
  .asString();
```

### C#

```csharp
using RestSharp;


var options = new RestClientOptions("https://admin-api.alchemy.com/v1/chains");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
var response = await client.GetAsync(request);

Console.WriteLine("{0}", response.Content);

```


## Operation Specification

```yaml
path: /v1/chains
method: GET
operation:
  operationId: ListChains
  responses:
    '200':
      description: Retrieved chains successfully
      content:
        application/json:
          schema:
            description: |-
              Standard API response wrapper.
              All API responses are wrapped in this format for consistency.
            properties:
              data:
                items:
                  properties:
                    id:
                      type: string
                      description: Alchemy chain network id (`{chain}_{network}`).
                    name:
                      type: string
                      description: Display name for the network.
                    networkChainId:
                      type: string
                      nullable: true
                      description: EIP-155 network chain id when available. Null for non-EVM chains.
                    isTestnet:
                      type: boolean
                      description: Indicates whether the network is a testnet.
                    availability:
                      description: Availability for the network (public, prerelease, deprecated).
                      enum:
                        - prerelease
                        - public
                        - deprecated
                      type: string
                    docsUrl:
                      type: string
                      description: Useful documentation link for the network.
                    explorerUrl:
                      type: string
                      description: Explorer URL for the network.
                    currency:
                      type: string
                      description: Native currency ticker.
                  required:
                    - id
                    - name
                    - isTestnet
                    - availability
                    - docsUrl
                    - explorerUrl
                    - currency
                  type: object
                  additionalProperties: false
                type: array
            required:
              - data
            type: object
            additionalProperties: false
    '401':
      description: Requires authentication
      content:
        application/json:
          schema:
            description: |-
              Standard error response wrapper.
              All error responses are wrapped in this format for consistency.
            properties:
              error:
                properties:
                  message:
                    type: string
                  code:
                    anyOf:
                      - type: integer
                        format: int32
                      - enum:
                          - 500
                          - 400
                          - 401
                          - 403
                          - 404
                          - 200
                          - 201
                          - 1000
                        type: number
                  status:
                    type: integer
                    format: int32
                  context:
                    description: Additional information about the error specific to the endpoint.
                    properties: {}
                    type: object
                    additionalProperties: {}
                required:
                  - message
                  - code
                  - status
                type: object
                additionalProperties: false
            required:
              - error
            type: object
            additionalProperties: false
          examples:
            Example 1:
              value:
                error:
                  code: 401
                  status: 401
                  message: Requires authentication
    '403':
      description: Forbidden
      content:
        application/json:
          schema:
            description: |-
              Standard error response wrapper.
              All error responses are wrapped in this format for consistency.
            properties:
              error:
                properties:
                  message:
                    type: string
                  code:
                    anyOf:
                      - type: integer
                        format: int32
                      - enum:
                          - 500
                          - 400
                          - 401
                          - 403
                          - 404
                          - 200
                          - 201
                          - 1000
                        type: number
                  status:
                    type: integer
                    format: int32
                  context:
                    description: Additional information about the error specific to the endpoint.
                    properties: {}
                    type: object
                    additionalProperties: {}
                required:
                  - message
                  - code
                  - status
                type: object
                additionalProperties: false
            required:
              - error
            type: object
            additionalProperties: false
          examples:
            Example 1:
              value:
                error:
                  code: 403
                  status: 403
                  message: Forbidden
  description: Retrieves a list of all blockchain networks supported by Alchemy, including their identifiers, display names, testnet status, and availability. Use this endpoint to discover valid network values for configuring app network allowlists.
  summary: List chains
  security:
    - api_key:
        - ADMIN_APPS_READ
        - ADMIN_APPS_READ_WRITE
    - user_auth:
        - developer
        - admin
  parameters: []
```