MITPO AssistantDevelopers

API Reference

Complete documentation for the MITPO Universal API

Base URL

https://api.mitpo.io

Dispatches

Dispatches are the operational core of MITPO. Each launch produces execution records you can inspect, automate around, and use to debug failures or confirm provider delivery.

Execution lifecycle

accepted→validating→dispatched→completed|failed
GET/v1/dispatches

List dispatches with pagination.

Request
curl "https://api.mitpo.io/v1/dispatches?status=completed&limit=5" \
  -H "Authorization: Bearer mk_live_..."
Response 200
{
  "success": true,
  "data": [
    {
      "id": "dsp_a1b2c3d4",
      "campaign_id": "cmp_f7k2a9m1x3",
      "channel": "meta_ads",
      "status": "completed",
      "provider_resource_id": "23851234567890",
      "created_at": "2026-03-22T10:00:00Z",
      "completed_at": "2026-03-22T10:02:34Z"
    }
  ],
  "pagination": {
    "has_more": false,
    "next_cursor": null
  },
  "request_id": "req_4d6e8f0g..."
}
GET/v1/dispatches/:id

Get the full status and provider response for a single dispatch.

Request
curl https://api.mitpo.io/v1/dispatches/dsp_a1b2c3d4 \
  -H "Authorization: Bearer mk_live_..."
Response 200
{
  "success": true,
  "data": {
    "id": "dsp_a1b2c3d4",
    "campaign_id": "cmp_f7k2a9m1x3",
    "channel": "meta_ads",
    "status": "completed",
    "environment": "live",
    "provider_resource_id": "23851234567890",
    "provider_response": {
      "ad_set_id": "23851234567891",
      "effective_status": "ACTIVE"
    },
    "credits_charged": 1,
    "created_at": "2026-03-22T10:00:00Z",
    "completed_at": "2026-03-22T10:02:34Z"
  },
  "request_id": "req_1a3b5c7d..."
}

Ready to automate campaign operations?

Get an API keyTry the Playground