---
updatedAt: 2026-10-14T20:26:09.000Z
---

# List REST API keys

> 📘 NOTE:
> 
> Accounts API is currently available on a limited basis. Contact our [Customer Support Team](mailto:support@telesign.com) if you’d like to explore using this API.

Use this action to list details related to all REST API keys for this account. The key values are not returned.

## General requirements
* **Authentication:** [Basic](/enterprise/docs/authentication#basic-authentication) (easiest to implement) or [Digest](/enterprise/docs/authentication#digest-authentication)
* **Responds with:** `application/json`


# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Accounts API",
    "version": "2.0",
    "description": "Use this API to programmatically manage your Telesign accounts and their configurations.\n",
    "contact": {
      "email": "support@telesign.com",
      "name": "Telesign Customer Support Team"
    }
  },
  "servers": [
    {
      "url": "accounts.telesign.com"
    }
  ],
  "paths": {
    "/keys": {
      "parameters": [],
      "get": {
        "summary": "List REST API keys",
        "operationId": "listRestAPIKeys",
        "responses": {
          "200": {
            "description": "**Success.** A list of REST API key objects associated with this account was successfully returned.\n\nStatus code | Associated text string\n--|--\n5001|Key list was successfully retrieved.",
            "content": {
              "application/json": {
                "schema": {
                  "allOf": [
                    {
                      "$ref": "#/components/schemas/SharedResponseFields"
                    },
                    {
                      "type": "object",
                      "properties": {
                        "data": {
                          "type": "object",
                          "description": "Contains REST API key data. ",
                          "properties": {
                            "keys": {
                              "type": "array",
                              "minItems": 1,
                              "maxItems": 10,
                              "uniqueItems": true,
                              "items": {
                                "$ref": "#/components/schemas/RestAPIKey"
                              }
                            }
                          }
                        },
                        "status": {
                          "type": "object",
                          "properties": {
                            "code": {
                              "type": "integer",
                              "example": 5001
                            },
                            "description": {
                              "type": "string",
                              "example": "Key list was successfully retrieved."
                            }
                          }
                        }
                      }
                    }
                  ]
                },
                "examples": {
                  "Success": {
                    "value": {
                      "reference_id": "0123456789ABCDEF0123456789ABCDEF",
                      "status": {
                        "code": 5001,
                        "description": "Key list was successfully retrieved."
                      },
                      "data": {
                        "keys": [
                          {
                            "key_id": "123456",
                            "last_updated": "2024-01-01T00:00:00Z",
                            "expiration_date": "2026-09-05T00:00:00Z"
                          }
                        ]
                      }
                    }
                  }
                }
              }
            }
          },
          "401": {
            "$ref": "#/components/responses/AccountsShared401"
          },
          "403": {
            "$ref": "#/components/responses/AccountsShared403"
          },
          "429": {
            "$ref": "#/components/responses/AccountsShared429"
          },
          "503": {
            "$ref": "#/components/responses/AccountsShared503"
          }
        },
        "description": "> 📘 NOTE:\n> \n> Accounts API is currently available on a limited basis. Contact our [Customer Support Team](mailto:support@telesign.com) if you’d like to explore using this API.\n\nUse this action to list details related to all REST API keys for this account. The key values are not returned.\n\n## General requirements\n* **Authentication:** [Basic](/enterprise/docs/authentication#basic-authentication) (easiest to implement) or [Digest](/enterprise/docs/authentication#digest-authentication)\n* **Responds with:** `application/json`\n",
        "parameters": [],
        "tags": [
          "API Keys"
        ]
      }
    }
  },
  "components": {
    "schemas": {
      "RestAPIKey": {
        "title": "RestAPIKey",
        "allOf": [
          {
            "type": "object",
            "properties": {
              "key_id": {
                "type": "string",
                "description": "A unique identifier for managing this REST API key. Cannot be used as a token to authenticate REST API requests.",
                "example": "123456"
              }
            }
          },
          {
            "$ref": "#/components/schemas/RestAPIKeyDetails"
          }
        ]
      },
      "RestAPIKeyDetails": {
        "type": "object",
        "properties": {
          "last_updated": {
            "type": "string",
            "description": "When this REST API key was last updated.",
            "example": "2024-01-01T00:00:00Z"
          },
          "expiration_date": {
            "type": "string",
            "description": "The expiration date of this REST API key. A value of `never` indicates that this key never expires.",
            "example": "2025-01-01T00:00:00Z"
          }
        }
      },
      "SharedResponseFields": {
        "title": "SharedResponseFields",
        "type": "object",
        "properties": {
          "reference_id": {
            "type": "string",
            "description": "A unique, randomly generated hex value that identifies your web service request.",
            "example": "0123456789ABCDEF0123456789ABCDEF"
          },
          "status": {
            "$ref": "#/components/schemas/Status"
          }
        }
      },
      "Status": {
        "title": "Status",
        "type": "object",
        "description": "Contains properties related to the processing status of the transaction.",
        "properties": {
          "code": {
            "type": "integer",
            "description": "A numeric code that indicates the status of your transaction."
          },
          "description": {
            "type": "string",
            "description": "Text describing the status of your transaction."
          }
        }
      }
    },
    "securitySchemes": {
      "Basic": {
        "type": "http",
        "scheme": "basic",
        "description": "Easiest to implement. See [Basic Authentication](/enterprise/docs/authentication#basic-authentication) for more details."
      }
    },
    "responses": {
      "AccountsShared429": {
        "description": "**Rate limit exceeded.**\n\nStatus code | Associated text string\n-- | --\n5204 | Rate limit exceeded.\n",
        "content": {
          "application/json": {
            "schema": {
              "allOf": [
                {
                  "$ref": "#/components/schemas/SharedResponseFields"
                },
                {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "integer",
                          "example": 5204
                        },
                        "description": {
                          "type": "string",
                          "example": "Rate limit exceeded."
                        }
                      }
                    }
                  }
                }
              ]
            },
            "examples": {
              "Rate limit error": {
                "value": {
                  "reference_id": "0123456789ABCDEF0123456789ABCDEF",
                  "status": {
                    "code": 5204,
                    "description": "Rate limit exceeded."
                  }
                }
              }
            }
          }
        }
      },
      "AccountsShared401": {
        "description": "**Unauthorized.**\n\nStatus code | Associated text string\n-- | --\n5400 | Authentication failed.",
        "content": {
          "application/json": {
            "schema": {
              "allOf": [
                {
                  "$ref": "#/components/schemas/SharedResponseFields"
                },
                {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "integer",
                          "example": 5400
                        },
                        "description": {
                          "type": "string",
                          "example": "Authentication failed."
                        }
                      }
                    }
                  }
                }
              ]
            },
            "examples": {
              "Authentication failed": {
                "value": {
                  "reference_id": "0123456789ABCDEF0123456789ABCDEF",
                  "status": {
                    "code": 5400,
                    "description": "Authentication failed."
                  }
                }
              }
            }
          }
        }
      },
      "AccountsShared403": {
        "description": "**Forbidden.**\n\nStatus code | Associated text string\n-- | --\n5401 | No permissions for this resource.",
        "content": {
          "application/json": {
            "schema": {
              "allOf": [
                {
                  "$ref": "#/components/schemas/SharedResponseFields"
                },
                {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "integer",
                          "example": 5401
                        },
                        "description": {
                          "type": "string",
                          "example": "No permissions for this resource."
                        }
                      }
                    }
                  }
                }
              ]
            },
            "examples": {
              "Resource forbidden": {
                "value": {
                  "reference_id": "0123456789ABCDEF0123456789ABCDEF",
                  "status": {
                    "code": 5401,
                    "description": "No permissions for this resource."
                  }
                }
              }
            }
          }
        }
      },
      "AccountsShared503": {
        "description": "**Service unavailable.**\n\nStatus code | Associated text string\n-- | --\n5500 | System unavailable. Please try again later.",
        "content": {
          "application/json": {
            "schema": {
              "allOf": [
                {
                  "$ref": "#/components/schemas/SharedResponseFields"
                },
                {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "integer",
                          "example": 5500
                        },
                        "description": {
                          "type": "string",
                          "example": "System unavailable. Please try again later."
                        }
                      }
                    }
                  }
                }
              ]
            },
            "examples": {
              "System unavailable": {
                "value": {
                  "reference_id": "0123456789ABCDEF0123456789ABCDEF",
                  "status": {
                    "code": 5500,
                    "description": "System unavailable. Please try again later."
                  }
                }
              }
            }
          }
        }
      }
    }
  },
  "security": [
    {
      "Basic": []
    }
  ],
  "tags": [
    {
      "name": "API Keys"
    }
  ],
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true,
    "samples-enabled": true
  }
}
```