Get rate-limit headroom
import requests
url = "https://api.paywise.de/partner/v2/usage/"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.paywise.de/partner/v2/usage/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.get("https://api.paywise.de/partner/v2/usage/")
.header("Authorization", "Bearer <token>")
.asString();using RestSharp;
var options = new RestClientOptions("https://api.paywise.de/partner/v2/usage/");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
var response = await client.GetAsync(request);
Console.WriteLine("{0}", response.Content);
curl --request GET \
--url https://api.paywise.de/partner/v2/usage/ \
--header 'Authorization: Bearer <token>'{
"generated_at": "2026-07-17T10:00:00Z",
"limits": [
{
"limit": 600,
"remaining": 599,
"resets_at": "2026-07-17T10:01:00Z",
"scope": "token",
"used": 1,
"window_seconds": 60
},
{
"limit": 600,
"remaining": 599,
"resets_at": "2026-07-17T10:01:00Z",
"scope": "partner",
"used": 1,
"window_seconds": 60
},
{
"limit": 30,
"remaining": 30,
"resets_at": "2026-07-17T11:00:00Z",
"scope": "mail:company-create",
"used": 0,
"window_seconds": 3600
},
{
"limit": 60,
"remaining": 60,
"resets_at": "2026-07-17T11:00:00Z",
"scope": "mail:membership-create",
"used": 0,
"window_seconds": 3600
}
]
}{
"code": "not_authenticated",
"detail": "Authentication credentials were not provided."
}{
"code": "<string>",
"detail": "<string>",
"errors": [
{
"code": "<string>",
"field": "<string>",
"message": "<string>"
}
]
}{
"code": "<string>",
"detail": "<string>",
"errors": [
{
"code": "<string>",
"field": "<string>",
"message": "<string>"
}
]
}{
"code": "<string>",
"detail": "<string>",
"errors": [
{
"code": "<string>",
"field": "<string>",
"message": "<string>"
}
]
}{
"code": "<string>",
"detail": "<string>",
"errors": [
{
"code": "<string>",
"field": "<string>",
"message": "<string>"
}
]
}Reference and status
Get rate-limit headroom
Return an authoritative point-in-time snapshot of all rate-limit buckets applicable to the authenticated Partner credential. The call itself counts against the token and partner buckets. The snapshot also includes the hourly per-partner mail budgets mail:company-create (company creates) and mail:membership-create (membership invites, inline users included). Those two are charged only by successful commands.
GET
/
partner
/
v2
/
usage
/
Get rate-limit headroom
import requests
url = "https://api.paywise.de/partner/v2/usage/"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.paywise.de/partner/v2/usage/', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));HttpResponse<String> response = Unirest.get("https://api.paywise.de/partner/v2/usage/")
.header("Authorization", "Bearer <token>")
.asString();using RestSharp;
var options = new RestClientOptions("https://api.paywise.de/partner/v2/usage/");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("Authorization", "Bearer <token>");
var response = await client.GetAsync(request);
Console.WriteLine("{0}", response.Content);
curl --request GET \
--url https://api.paywise.de/partner/v2/usage/ \
--header 'Authorization: Bearer <token>'{
"generated_at": "2026-07-17T10:00:00Z",
"limits": [
{
"limit": 600,
"remaining": 599,
"resets_at": "2026-07-17T10:01:00Z",
"scope": "token",
"used": 1,
"window_seconds": 60
},
{
"limit": 600,
"remaining": 599,
"resets_at": "2026-07-17T10:01:00Z",
"scope": "partner",
"used": 1,
"window_seconds": 60
},
{
"limit": 30,
"remaining": 30,
"resets_at": "2026-07-17T11:00:00Z",
"scope": "mail:company-create",
"used": 0,
"window_seconds": 3600
},
{
"limit": 60,
"remaining": 60,
"resets_at": "2026-07-17T11:00:00Z",
"scope": "mail:membership-create",
"used": 0,
"window_seconds": 3600
}
]
}{
"code": "not_authenticated",
"detail": "Authentication credentials were not provided."
}{
"code": "<string>",
"detail": "<string>",
"errors": [
{
"code": "<string>",
"field": "<string>",
"message": "<string>"
}
]
}{
"code": "<string>",
"detail": "<string>",
"errors": [
{
"code": "<string>",
"field": "<string>",
"message": "<string>"
}
]
}{
"code": "<string>",
"detail": "<string>",
"errors": [
{
"code": "<string>",
"field": "<string>",
"message": "<string>"
}
]
}{
"code": "<string>",
"detail": "<string>",
"errors": [
{
"code": "<string>",
"field": "<string>",
"message": "<string>"
}
]
}Authorizations
Partner API Bearer key: Authorization: Bearer <key>. Keys are created only through authorized portal or staff flows.
