Creating an Access Token

All requests sent to pkmnapi must be authenticated using an access token.

To create an access token, send request to POST /v1/access_tokens with a valid email address:

⚠️ Requests sent to POST /v1/access_tokens are the only ones that must be unauthenticated

bash

curl \
    -X POST \
    -H 'Content-Type: application/json' \
    -d '{
    "data": {
        "type": "access_tokens",
        "attributes": {
            "email_address": "your@email.com"
        }
    }
}' \
    https://api.pkmnapi.com/v1/access_tokens

const xhr = new XMLHttpRequest();

xhr.addEventListener('load', () => {
    console.log(xhr.response);
});

xhr.open('POST', 'https://api.pkmnapi.com/v1/access_tokens', true);
xhr.setRequestHeader('Content-Type', 'application/json');
xhr.send(JSON.stringify({
    data: {
        type: 'access_tokens',
        attributes: {
            email_address: 'your@email.com'
        }
    }
}));

An email containing your access token will be sent to the provided email address.

📄 To prevent the frivolous generation of access tokens, there is a rate limit of 10 minutes on the POST /v1/access_tokens endpoint per email address

📄 Want more than 1 access token with the same email address? Consider using a "+" in your email: your+access+token@email.com, your+second+access+token@email.com, etc