Show the current user

Credits, today's free quota and whether the key is a sandbox key.

GEThttps://api.switchfile.io/v2/users/me

Needs an API key: Authorization: Bearer YOUR_API_KEY. See Authentication.

Example

Request

curl "https://api.switchfile.io/v2/users/me" \
  -H "Authorization: Bearer $SWITCHFILE_API_KEY"

const res = await fetch("https://api.switchfile.io/v2/users/me", {
  headers: {
    Authorization: `Bearer ${process.env.SWITCHFILE_API_KEY}`,
  },
});
if (!res.ok) throw new Error(`HTTP ${res.status}: ${await res.text()}`);
console.log(await res.json());

<?php
$ch = curl_init('https://api.switchfile.io/v2/users/me');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('SWITCHFILE_API_KEY'),
    ],
    CURLOPT_RETURNTRANSFER => true,
]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);
curl_close($ch);

if ($status >= 400) {
    throw new RuntimeException("HTTP $status: $response");
}
print_r(json_decode($response, true));

import os
import requests

res = requests.get(
    "https://api.switchfile.io/v2/users/me",
    headers={"Authorization": f"Bearer {os.environ['SWITCHFILE_API_KEY']}"},
)
res.raise_for_status()
print(res.json())

Responses

200OK
dataobjectrequired
data.can_convertbooleanrequired
data.created_atstringrequired
ISO 8601 timestamp, for example 2026-11-06T18:00:00+00:00
data.creditsstring (integer) | integerrequired
Paid credits left on the account
data.emailstringrequired
data.free_quotaobjectrequired
data.free_quota.availablebooleanrequired
data.free_quota.compute_minutes_per_daynumberrequired
data.free_quota.compute_minutes_usednumberrequired
data.free_quota.conversions_per_daystring (integer) | integerrequired
data.free_quota.conversions_usedstring (integer) | integerrequired
data.idstringrequired
data.linksobjectrequired
data.links.selfstringrequired
data.sandboxbooleanrequired
200 application/json
```
{
  "data": {
    "id": "4f8a2c6e-1b3d-4e5f-8a7c-9d0b2e4f6a18",
    "email": "[email protected]",
    "credits": 1200,
    "created_at": "2026-10-01T09:30:00+00:00",
    "free_quota": {
      "conversions_per_day": 50,
      "conversions_used": 3,
      "compute_minutes_per_day": 20,
      "compute_minutes_used": 0.4,
      "available": true
    },
    "can_convert": true,
    "sandbox": false,
    "links": {
      "self": "https://api.switchfile.io/v2/users/me"
    }
  }
}
```

401The API key is missing or not validUNAUTHENTICATED

401 application/json

{
  "message": "Missing or invalid API key.",
  "code": "UNAUTHENTICATED"
}

404Does not exist for this accountNOT_FOUND
404 application/json
```
{
  "message": "Job not found.",
  "code": "NOT_FOUND"
}
```

422Invalid data. errors names the fieldsINVALID_DATA

422 application/json

{
  "message": "id: Expected string to match 'uuid' format",
  "code": "INVALID_DATA",
  "errors": {
    "id": [
      "Expected string to match 'uuid' format"
    ]
  }
}

429Too many requests or a daily quota is used up. See Retry-AfterRATE_LIMIT_EXCEEDED
429 application/json
```
{
  "message": "Too many requests. Try again in 12 seconds.",
  "code": "RATE_LIMIT_EXCEEDED"
}
```

Error bodies and codes are explained in Errors.