List messages

GET

https://api2.freecustom.email/v1/inboxes/:inbox/messages

GET

/v1/inboxes/:inbox/messages

1 import requests
2 
3 url = "https://api2.freecustom.email/v1/inboxes/string/messages"
4 
5 querystring = {"limit":"20","before":"string"}
6 
7 headers = {"Authorization": "Bearer <token>"}
8 
9 response = requests.get(url, headers=headers, params=querystring)
10 
11 print(response.json())

1 {
2   "data": {
3     "count": 3338,
4     "inbox": "string",
5     "has_more": false,
6     "messages": [
7       {
8         "id": "string",
9         "otp": "string",
10         "date": "2025-01-04T10:08:40.720Z",
11         "from": "string",
12         "subject": "string",
13         "has_attachment": false,
14         "verification_link": "string"
15       },
16       {
17         "id": "string",
18         "otp": "string",
19         "date": "1955-01-15T16:03:05.610Z",
20         "from": "string",
21         "subject": "string",
22         "has_attachment": false,
23         "verification_link": "string"
24       }
25     ]
26   },
27   "success": true
28 }

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

inboxstringRequired

Query parameters

limitintegerOptional

beforestringOptional

Message ID — returns messages older than this

Response

dataobject

successboolean

Errors

401

Unauthorized Error

403

Forbidden Error

429

Too Many Requests Error