---
updatedAt: 2026-08-24T09:14:57.000Z
agentTools:
projectIndex: https://developers.vibe.co/llms.txt
---
# List accounts
**Scopes:**
`account:read`
*Rate limits*:
Burst: `10/s`
Steady: `300/m`
# OpenAPI definition
```json
{
"openapi": "3.1.0",
"paths": {
"/accounts": {
"get": {
"operationId": "listAccounts",
"parameters": [],
"responses": {
"200": {
"description": "Account list response",
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/Account"
}
}
}
}
},
"400": {
"description": "Bad request error response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
},
"examples": {
"missingApiKey": {
"summary": "Missing API key",
"value": {
"error": {
"type": "validation",
"message": "Missing API Key",
"status": 400,
"detail": null,
"request_id": "req_8f3a4b2c",
"doc_url": null
}
}
},
"validationError": {
"summary": "Validation error",
"value": {
"error": {
"type": "validation",
"message": "Validation error",
"status": 400,
"detail": {
"validation": [
"id must be a string"
]
},
"request_id": "req_8f3a4b2c",
"doc_url": null
}
}
}
}
}
}
},
"401": {
"description": "Unauthorized error response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
},
"examples": {
"invalidApiKey": {
"summary": "Invalid API key",
"value": {
"error": {
"type": "invalid_token",
"message": "Unauthorized",
"status": 401,
"detail": null,
"request_id": "req_8f3a4b2c",
"doc_url": "https://developers.vibe.co/errors/invalid-token"
}
}
}
}
}
}
},
"403": {
"description": "Insufficient scope error response",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
},
"examples": {
"insufficientScope": {
"summary": "Missing required scope",
"value": {
"error": {
"type": "insufficient_scope",
"message": "Missing required scope",
"status": 403,
"detail": {
"required": "account:read",
"granted": [
"test"
]
},
"request_id": "req_8f3a4b2c",
"doc_url": "https://developers.vibe.co/reference/oauth2token"
}
}
}
}
}
}
}
},
"summary": "List accounts",
"tags": [
"Accounts"
],
"x-rate-limit": {
"rps": 10,
"rpm": 300
},
"x-scopes": [
"account:read"
],
"description": "**Scopes:**\n`account:read`\n
*Rate limits*:
Burst: `10/s`
Steady: `300/m`\n"
}
}
},
"info": {
"title": "Vibe Public API",
"description": "Vibe Public API revision 2026-06-01",
"version": "2026-06-01",
"contact": {}
},
"tags": [
{
"name": "Accounts",
"description": "An Account is the Vibe organization a partner app acts on behalf of. It owns the advertisers, campaigns, creatives, audiences, and balance that the rest of this API operates on.\n\nThese are the only endpoints that operate across accounts — they are keyed on the calling app rather than on one account. Every other endpoint resolves a single account from the access token; embedded apps carry a wildcard tenant context and pass `account_id` to select one."
}
],
"servers": [
{
"url": "https://api.vibe.co",
"description": "Production API"
}
],
"components": {
"securitySchemes": {
"bearer": {
"scheme": "bearer",
"bearerFormat": "JWT",
"type": "http"
}
},
"schemas": {
"ErrorDetail": {
"type": "object",
"properties": {
"required": {
"type": "string",
"example": "audiences:write"
},
"granted": {
"example": [
"audiences:read",
"reporting:read"
],
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"required",
"granted"
]
},
"ApiError": {
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"insufficient_scope",
"invalid_token",
"validation",
"internal_error"
]
},
"message": {
"type": "string"
},
"status": {
"type": "number",
"example": 403
},
"detail": {
"nullable": true,
"allOf": [
{
"$ref": "#/components/schemas/ErrorDetail"
}
]
},
"request_id": {
"type": "string",
"example": "req_8f3a4b2c"
},
"doc_url": {
"type": "string",
"example": "https://developers.vibe.co/reference/oauth2token",
"nullable": true
}
},
"required": [
"type",
"message",
"status",
"request_id"
]
},
"ErrorResponse": {
"type": "object",
"properties": {
"error": {
"$ref": "#/components/schemas/ApiError"
}
},
"required": [
"error"
]
},
"Account": {
"type": "object",
"properties": {
"id": {
"type": "number",
"description": "Stable identifier of the account"
},
"name": {
"type": "string",
"description": "Display name of the account"
},
"currency": {
"type": "string",
"description": "Currency of the account"
},
"timezone": {
"type": "string",
"description": "Timezone of the account"
},
"status": {
"type": "string",
"description": "Current account status",
"enum": [
"ACTIVE",
"BLOCKED",
"ONBOARDING"
]
},
"created_at": {
"type": "string",
"description": "Timestamp when the account was created",
"format": "date-time"
},
"updated_at": {
"type": "string",
"description": "Timestamp when the account was last updated",
"format": "date-time"
}
},
"required": [
"id",
"name",
"currency",
"timezone",
"status",
"created_at",
"updated_at"
]
}
}
},
"security": [
{
"bearer": []
}
]
}
```