List Placement Tests

GET

/v1/placement

Retrieve all placement (deliverability) tests created by the authenticated user.

Request

Authorization

API Key

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200

application/json

Placement tests fetched successfully

Bodyapplication/json

Example

{
    "status": 200,
    "message": "Placement tests fetched successfully.",
    "data": [
        {
            "id": "plt_abc1",
            "name": "Q4 Campaign Test",
            "status": "completed",
            "createdAt": "2025-10-02T15:45:32.267Z",
            "report": {
                "inboxRate": 87.5,
                "spamRate": 12.5,
                "healthScore": 78,
                "healthLabel": "Good"
            }
        }
    ]
}

🟠401

🔴500

Assign Mailboxes to Domain

Create Placement Test