---
title: "account/keys/retrieve"
method: GET
path: "/account/keys/retrieve"
tags: ["API Key Endpoints"]
---

# account/keys/retrieve

`GET /account/keys/retrieve`

## Request

- Base URL: `https://earthnode-dev.vopay.com/api/v2`
- URL: `https://earthnode-dev.vopay.com/api/v2/account/keys/retrieve`
- Auth: none declared

This endpoint allows the user to fetch a particular API key associated with their account including sensitive information.

## Request body `application/x-www-form-urlencoded`

- object
  - `AccountID` string, required: Your account ID
  - `Key` string, required: API key for the account
  - `Signature` string, required: Hashed signature for the request
  - `KeyID` integer, required: The ID of the key. Can be fetched through the /keys endpoint

## Response `200`

- object
  - `Success` boolean, required: True if the request was successful, false if it failed
  - `ErrorMessage` string, required: Contains a description of the error if the request failed
  - `Key` object, required: Array serialized as a JSON object (JSON_FORCE_OBJECT): numeric string keys '0','1',... The API Key associated with the account. Empty {} when no key is returned.
    - `0` object
      - `KeyID` integer, required: ID associated with the key. Can be used with the retrieve endpoint to get sensitive key data
      - `Label` string, required: The user submitted label for the API Key
      - `Key` string, required: The actual key value
      - `Secret` string, required: The secret associated with the key
      - `AccessScope` string, required: The scope of access associated with the key

---

[API](https://skmtc.dev/vopay/apis/integrations-and-support.md) - [All operations](https://skmtc.dev/vopay/apis/integrations-and-support/llms.txt) - [OpenAPI document](https://skmtc.dev/vopay/apis/integrations-and-support/revisions/e88c512ce5f0?raw)