Get a contact

GET/api/v2/contacts/{username_or_id}

Returns one contact. When you look it up by id, deleted contacts are returned too.

Rate limit 300 requests per minute

Headers

  • x-api-keyheaderRequired

    Your API key.

  • Content-Typeheader

    application/json. Not needed for this request.

Path parameters

  • username_or_idstringRequired

    Instagram username or contact id.

Query parameters

  • fieldsstring

    full (default) or basic.

Errors

ErrorWhen
404contact_not_found
No contact with that username or id in your organization.
Request
curl "https://app.dmtracker.ai/api/v2/contacts/jane.fitness" \
  -H "x-api-key: $DMTRACKER_API_KEY" \
  -H "Content-Type: application/json"
Response 200
{
  "status": "success",
  "data": {
    "id": "7c1e9a52-3f4b-4d2a-9e61-0b8f2d5c4a17",
    "username": "jane.fitness",
    "full_name": "Jane Cooper",
    "profile_picture": null,
    "source": "inbound",
    "status": "open",
    "pipeline_stage": {
      "id": "9e4a7c21-6b0d-4e8f-b352-1a9c8d7e6f03",
      "name": "In Conversation",
      "color": "#FF8A2E",
      "position": 3
    },
    "tags": [
      {
        "id": 287,
        "name": "hot lead",
        "color": "#22C55E"
      }
    ],
    "follow_up": {
      "state": "pending",
      "stage": {
        "id": "4d8b2f6e-1a3c-4e9b-8f70-6c2a5e9d1b38",
        "name": "1st Follow-Up"
      },
      "count": 0,
      "due_at": "2026-10-22T03:14:50.000+00:00",
      "overdue_days": 1,
      "snoozed_until": null,
      "snooze_reason": null,
      "last_follow_up_sent_at": null,
      "disabled_at": null,
      "disabled_by": null
    },
    "outbound": {
      "sent_at": null,
      "reason": null,
      "message": null,
      "message_label": null,
      "tracked_manually": null,
      "tracked_by_team_member": null,
      "replied_at": null
    },
    "conversation": {
      "last_message_at": "2026-10-21T15:14:50.000+00:00",
      "last_message_from": "user",
      "last_message": "Happy to help! Want me to send you the program details?",
      "last_contact_message_at": "2026-10-21T15:12:47.000+00:00",
      "first_contact_message_at": "2026-10-21T15:12:47.000+00:00",
      "can_reply": false,
      "reply_window_expires_at": "2026-10-22T15:12:47.000+00:00"
    },
    "instagram": {
      "inactive": false,
      "url": "https://instagram.com/jane.fitness"
    },
    "assigned_user": "alex@yourcompany.com",
    "added_by": "dm_tracker",
    "created_by_user": null,
    "created_at": "2026-10-21T15:12:47.000+00:00"
  }
}
Link copied