Skip to main content

Account (/v1/me)

GET /v1/me​

Shows who the key belongs to, its scopes, the limits and current usage. Use it to test a new key. It works with any scope.

curl https://api.validades.com/v1/me \
-H "Authorization: Bearer vld_live_YOUR_KEY"

200 response​

FieldTypeDescription
organization.idUUIDorganization
organization.nametextorganization name
workspace.idUUIDdata workspace of the organization
api_key.idUUIDkey id
api_key.nametextname given to the key
api_key.last_fourtextlast 4 characters of the key
api_key.scopeslistread, write, delete
api_key.expires_atdate-time or nullkey expiration
api_key.created_atdate-timecreation
limits.key_requests_per_minutenumberper-minute limit of the key
limits.organization_requests_per_minutenumberper-minute limit of the organization
limits.monthly_quotanumbermonthly quota
usage.month.periodtextquota month (YYYY-MM, UTC)
usage.month.usednumber or nullrequests this month, including this one
usage.month.remainingnumber or nullrequests left
usage.month.resets_atdate-timequota reset
usage.today.datedateday (UTC)
usage.today.usednumber or nullrequests today, including this one

Usage numbers may be null if the counter is temporarily unavailable.

See the full example in Getting started.