GET /user/apikey

Returns metadata about the API key of a sub-account. Use it to check whether a sub-account currently has a key.

📘

Authorization

Only parent accounts can retrieve API key metadata for their sub-accounts. The sub-account must be owned by the authenticated parent.

📘

Metadata only

This endpoint does not return the actual api_key value — only id, user_id, and created_at. The full key is shown once, at creation time, via POST /user/apikey. If the key was lost, generate a new one.

HTTP Method & Path

GET /user/apikey?isSubaccount=true&userId={subaccount_id}

Base URL: https://api-v2.pandavideo.com.br

Authentication Requirements

• Security Scheme: PandaAuth (apiKey)
• Header: Authorization: <your_api_token> (no Bearer prefix)

Parameters

Query Parameters

Response

Success Response (200)

{
  "apikey": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "user_id": "subaccount_user_id",
    "created_at": "2026-01-01T00:00:00.000Z"
  }
}

⚠️

Unlike POST /user/apikey, this endpoint never returns the api_key value.

Error Responses

• 400 Bad Request — missing/invalid query params or ownership failures ("subaccount does not belong to the user", etc.).
• 401 Unauthorized — Invalid or missing API token.
• 404 Not Found — "apikey not found" (the sub-account has no API key).
• 500 Internal Server Error — Server error.

Example Usage

cURL

curl -X GET \
  'https://api-v2.pandavideo.com.br/user/apikey?isSubaccount=true&userId=your_subaccount_id_here' \
  -H 'Authorization: your_api_token_here'