REFERENCE

Account info

GET/v1/meta

The account the key belongs to, its ID profile, the number of medicines and the time of the last import. Use it to check that a key works.

Requestcurl

curl https://api.oushodh.dev/v1/meta \
  -H "Authorization: Bearer $OUSHODH_KEY"

Response

Your account and the data.

FIELD	TYPE	WHAT IT HOLDS
`client`	string	The account the key belongs to.
`id_profile`	string	The ID profile your medicine IDs come from.
`medicines`	integer	How many medicines the API holds.
`last_import`	time	When the data was last imported.

Response200

{
  "client": "[your account]",
  "id_profile": "[your ID profile]",
  "medicines": 58937,
  "last_import": "2026-11-09T15:27:40Z"
}

Each error has a code and a message.

STATUS	CODE	WHEN
`401`	`unauthorized`	No key, an unknown key or a revoked key. The answer never says which.
`403`	`plan_expired`	The key's account has no active plan.
`429`	`rate_limited`	More requests in a minute than the key's plan allows.
`429`	`quota_exceeded`	The plan's requests for this month are used up.
`500`	`internal`	A fault on our side. The details go to our log, not the answer.

401 unauthorizedNo key, an unknown key or a revoked key. The answer never says which.
403 plan_expiredThe key's account has no active plan.
429 rate_limitedMore requests in a minute than the key's plan allows.
429 quota_exceededThe plan's requests for this month are used up.
500 internalA fault on our side. The details go to our log, not the answer.