Authentication


All API requests require authentication using your secret key. Use it in the Authorization header as a Bearer token.

i
Authorization: Bearer YOUR_SECRET_KEY

Base URL https://api.piggyvest.business (or your provided PVB_BASE_URL ).

Environment Variables

PVB_SECRET_KEY : Your API secret key
PVB_BASE_URL : The base API URL

Error Handling

Errors return a JSON object with status: false and a message . Common HTTP status codes:

400: Bad request (e.g., validation errors)
401: Unauthorized (invalid key)
404: Not found
500: Internal server error

Rate Limits

(Assuming standard limits; confirm with support if needed. Typically, 100 requests/minute in test mode.)