---
updatedAt: 2025-12-01T10:51:05.000Z
agentTools:
  projectIndex: https://docs.tatum.io/llms.txt
---

# Get all endpoints

Retrieve all endpoints for the authenticated user. Supports optional filtering via query parameters such as display name, chain, network, interface, status, or routing options.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "servers": [
    {
      "url": "https://api.tatum.io/v4/manage",
      "description": "Core API Production"
    }
  ],
  "info": {
    "title": "GATEWAY MANAGE API",
    "version": "0.0.1",
    "description": "",
    "license": {
      "name": "UNLICENSED"
    }
  },
  "paths": {
    "/endpoint": {
      "get": {
        "summary": "Get all endpoints",
        "description": "Retrieve all endpoints for the authenticated user. Supports optional filtering via query parameters such as display name, chain, network, interface, status, or routing options.",
        "tags": [
          "Endpoint"
        ],
        "parameters": [
          {
            "name": "displayName",
            "in": "query",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 100,
              "example": "My Custom Ethereum RPC"
            },
            "required": false,
            "description": "Human-readable name of the endpoint. This is the label that will be shown in dashboards, UIs, and other tools."
          },
          {
            "name": "chain",
            "in": "query",
            "schema": {
              "type": "string",
              "example": "ethereum"
            },
            "required": false,
            "description": "Blockchain the endpoint is connected to. Example values include \"ethereum\", \"polygon\", etc."
          },
          {
            "name": "network",
            "in": "query",
            "schema": {
              "type": "string",
              "example": "ethereum-mainnet"
            },
            "required": false,
            "description": "Network of the selected blockchain. Example values include \"ethereum-mainnet\", \"polygon-mumbai\", etc."
          },
          {
            "name": "interface",
            "in": "query",
            "schema": {
              "type": "string",
              "example": "ethereum-mainnet-json-rpc"
            },
            "required": false,
            "description": "Interface or protocol used by the endpoint. Examples include \"ethereum-mainnet-json-rpc\", \"ethereum-mainnet-beacon\", \"polygon-mumbai-json-rpc\", etc."
          },
          {
            "name": "isActive",
            "in": "query",
            "schema": {
              "type": "boolean"
            },
            "required": false,
            "description": "Indicates whether the endpoint is currently active. Only active endpoints are considered for routing and traffic."
          },
          {
            "name": "url",
            "in": "query",
            "schema": {
              "type": "string",
              "example": "https://ethereum-mainnet.your.provider.io"
            },
            "required": false,
            "description": "URL of the endpoint. This is the base URL that will be used to send requests to the endpoint."
          },
          {
            "name": "provider",
            "in": "query",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 50,
              "example": "RPC Provider Name"
            },
            "required": false,
            "description": "Optional provider name for the endpoint. his can be used to specify the infrastructure or RPC provider powering this endpoint."
          }
        ],
        "responses": {
          "200": {
            "description": "A list of endpoints matching the applied filters",
            "content": {
              "application/json": {
                "schema": {
                  "type": "array",
                  "items": {
                    "$ref": "#/components/schemas/Endpoint"
                  }
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HttpExceptionDto"
                },
                "example": {
                  "statusCode": 401,
                  "timestamp": "2025-11-24T17:39:49.778Z",
                  "path": "/endpoint?displayName=My%20Custom%20Ethereum%20RPC&chain=ethereum&network=ethereum-mainnet&interface=ethereum-mainnet-json-rpc&url=https%3A%2F%2Fmainnet.tatum.io%2Fv3%2FYOUR-API-KEY&provider=Tatum",
                  "message": "Authentication required. Make sure your requests are authenticated with a Tatum API key. Find out how at: https://co.tatum.io/docs_authentication. If you don't have one, get one for FREE via the Tatum Dashboard at https://co.tatum.io/signup",
                  "details": {
                    "error": "Unauthorized"
                  }
                }
              }
            }
          }
        },
        "security": [
          {
            "X-API-Key": []
          }
        ],
        "x-samchon-accessor": [
          "endpoint",
          "findAll"
        ],
        "x-samchon-controller": "EndpointController"
      }
    }
  },
  "components": {
    "schemas": {
      "HttpExceptionDto": {
        "type": "object",
        "properties": {
          "message": {
            "type": "string"
          },
          "statusCode": {
            "type": "number"
          },
          "timestamp": {
            "type": "string"
          },
          "path": {
            "type": "string"
          },
          "details": {}
        },
        "required": [
          "message",
          "statusCode",
          "timestamp",
          "path"
        ]
      },
      "Endpoint": {
        "type": "object",
        "properties": {
          "version": {
            "const": 1,
            "description": "Used to version this schema so it can evolve over time without requiring database migrations. This value is fixed for this version of the schema."
          },
          "id": {
            "type": "string",
            "format": "uuid",
            "example": "a1b2c3d4-e5f6-7890-1234-567890abcdef",
            "description": "This value is a UUID and serves as the primary key. It is used to reference and manage the endpoint later in the system."
          },
          "displayName": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100,
            "example": "My Custom Ethereum RPC",
            "description": "Human-readable name of the endpoint. This is the label that will be shown in dashboards, UIs, and other tools."
          },
          "chain": {
            "type": "string",
            "example": "ethereum",
            "description": "Blockchain the endpoint is connected to. Example values include \"ethereum\", \"polygon\", etc."
          },
          "network": {
            "type": "string",
            "example": "ethereum-mainnet",
            "description": "Network of the selected blockchain. Example values include \"ethereum-mainnet\", \"polygon-mumbai\", etc."
          },
          "interface": {
            "type": "string",
            "example": "ethereum-mainnet-json-rpc",
            "description": "Interface or protocol used by the endpoint. Examples include \"ethereum-mainnet-json-rpc\", \"ethereum-mainnet-beacon\", \"polygon-mumbai-json-rpc\", etc."
          },
          "isActive": {
            "type": "boolean",
            "description": "Indicates whether the endpoint is currently active. Only active endpoints are considered for routing and traffic."
          },
          "url": {
            "type": "string",
            "example": "https://ethereum-mainnet.your.provider.io",
            "description": "URL of the endpoint. This is the base URL that will be used to send requests to the endpoint."
          },
          "headers": {
            "$ref": "#/components/schemas/RecordHeaderKeyHeaderValue",
            "example": {
              "x-api-key": "your-secret-key"
            },
            "description": "HTTP headers that will be sent with each request to this endpoint. Commonly used for authentication (for example, API keys or tokens) or other required custom headers."
          },
          "ownerId": {
            "type": "string",
            "example": "692391f00000000000000000",
            "description": "Identifier of the owner of this endpoint. Typically this is the ID of the customer, account, or organization that created and manages the endpoint."
          },
          "provider": {
            "type": "string",
            "minLength": 1,
            "maxLength": 50,
            "example": "RPC Provider Name",
            "description": "Optional provider name for the endpoint. his can be used to specify the infrastructure or RPC provider powering this endpoint."
          },
          "createdAt": {
            "type": "string",
            "description": "Date and time when the endpoint was created.",
            "format": "date-time"
          },
          "updatedAt": {
            "type": "string",
            "description": "Date and time when the endpoint was last updated.",
            "format": "date-time"
          }
        },
        "required": [
          "version",
          "id",
          "displayName",
          "chain",
          "network",
          "interface",
          "isActive",
          "url",
          "headers",
          "ownerId",
          "createdAt",
          "updatedAt"
        ]
      },
      "RecordHeaderKeyHeaderValue": {
        "type": "object",
        "properties": {},
        "required": [],
        "description": "Construct a type with a set of properties K of type T",
        "additionalProperties": {
          "type": "string",
          "minLength": 1,
          "maxLength": 200
        }
      }
    },
    "securitySchemes": {
      "X-API-Key": {
        "type": "apiKey",
        "name": "x-api-key",
        "in": "header",
        "description": "Your **API key** is used to identify your account & your plan, including the number of API calls per second and total monthly calls you have.\n\nIf you don't have a key already you can [Sign up for a Free Tatum account](https://co.tatum.io/signup)."
      }
    }
  },
  "tags": [
    {
      "name": "Endpoint"
    }
  ],
  "x-samchon-emended-v4": true
}
```