---
title: "Meta connection status"
method: GET
path: "/meta-ads/status"
tags: ["Meta Ads"]
---

# Meta connection status

`GET /meta-ads/status`

Whether this shop's Meta integration is live, and what it is wired to: the Facebook Page, the Instagram Business account, the ad account and the Business Manager. This is the cheap call — it reads the stored authorization rather than fanning out to Meta, with a single best-effort Instagram profile fetch layered on top (its failure degrades the `ig` object, never the response). 

`connected: false` covers both never-connected and revoked/expired-and-not-yet-repaired; a shop in the latter state answers 409 `META_REAUTH_REQUIRED` on the endpoints that call Meta. Poll this before the network-bound reads. Single shop only.

## Response `200`

Successful Response

- StatusResponse
  - `connected` boolean, required
  - `page` ConnectedEntity
    - `id` string, nullable
    - `name` string, nullable
  - `ig` ConnectedIGEntity
    - `id` string, nullable
    - `username` string, nullable
  - `ad_account` ConnectedEntity
    - `id` string, nullable
    - `name` string, nullable
  - `business` ConnectedEntity
    - `id` string, nullable
    - `name` string, nullable

---

[API](https://skmtc.dev/reacherapp/apis/reacher-data-api.md) · [All operations](https://skmtc.dev/reacherapp/apis/reacher-data-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/reacherapp/reacher-data-api/revisions/5eefff009b5b/schema)