Skip to main content
GET
/
v1
/
me
Get current identity
curl --request GET \
  --url https://api.mareaalcalina.com/v1/me \
  --header 'Authorization: Bearer <token>'
{
  "id": "usr_abc123",
  "email": "<string>",
  "displayName": "<string>",
  "rateLimit": {
    "rpm": 60,
    "rpd": 10000,
    "remainingMinute": 1,
    "remainingDay": 1
  },
  "keyId": "<string>",
  "_links": {
    "upgradeUrl": "<string>",
    "dashboardUrl": "<string>",
    "developerDashboardUrl": "<string>"
  },
  "tosAcceptedAt": "<string>",
  "plan": {
    "tier": "free",
    "limits": {
      "storefronts": 1,
      "products": 1,
      "publishable": true
    }
  },
  "planQuantity": 123
}

Authorizations

​
Authorization
string
header
required

Marea API key. mk_dev_* keys are developer-scoped (bootstrap, list users, register webhook). mk_user_* keys are user-scoped (manage that one user's storefronts/products). Scopes: catalog:read, catalog:write, storefront:publish, me:verify, me:resendVerification, developer:bootstrap, developer:read, developer:issueUserKey, developer:webhooks.

Headers

​
Accept-Language
string

BCP-47 locale tag for localized error messages (es, en, pt). Defaults to es.

Example:

"es-MX"

Response

Success.

Identity + plan info for the calling key. Available to both user and developer keys (branched by type).

​
id
string
required
Example:

"usr_abc123"

​
type
enum<string>
required
Available options:
user,
developer
​
email
string
required
​
displayName
string
required
​
rateLimit
object
required
​
keyId
string | null
required
​
_links
object
required
​
verificationStatus
enum<string> | null
Available options:
pending,
verified
​
tosAcceptedAt
string | null
​
plan
object
​
planQuantity
integer | null