FirstMail

Experience seamless email management with our innovative solutions. Stay connected, stay informed.

API Documentation

Explore our comprehensive API documentation to integrate with our services easily.

Request for Full Data

import requests

headers = {
    'e-mail': 'example@firstmail.pl',
    'password': 'your_password'
}

# full data
response = requests.get('https://firstmail.pl/api/mail/json', headers=headers)

curl -H "e-mail: example@firstmail.pl" \
     -H "password: your_password" \
     https://firstmail.pl/api/mail/json

Request for Verification Codes

You can use this request below, or this page

import requests

headers = {
    'e-mail': 'example@firstmail.pl',
    'password': 'your_password'
}

# only verification code
response = requests.get('https://firstmail.pl/api/mail/code/json', headers=headers)

curl -H "e-mail: example@firstmail.pl" \
     -H "password: your_password" \
     https://firstmail.pl/api/mail/code/json

Responses

Status 200 - Success

Response for a successful request will be in JSON format with email data.

{
    "success": true,
    "data": [
        {
            "title": "Your Subject",
            "from": "sender@example.com",
            "message": "Message body",
            "code": "123456", // could also be null or ""
            "links": ["https://example.com", "https://another-link.com"]
        }
        // Additional emails...
    ]
}

Status 400 - Failed Authentication

Response when e-mail or password are missing from headers.

{
    "success": false,
    "error": "Missing e-mail or password in headers"
}

Status 401 - Unauthorized

Response when authentication fails.

{
    "success": false,
    "error": "Authentication failed"
}