> ## Documentation Index
> Fetch the complete documentation index at: https://docs.polymorfa.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get marketing status

> **Protocols:** Meta Cloud API

**Required scope:** `sessions:read`

Reads Meta's WABA marketing status fields through a project-owned Official API Number. Values are returned without interpreting eligibility or terms acceptance. This is a Polymorfa WABA-scoped path, not a Meta edge.

Use a WABA ID from an Official API Number in your project and a credential with
`sessions:read`. The response returns Meta's raw
`marketing_messages_lite_api_status` and `marketing_messages_onboarding_status`
strings when Meta provides them. The route rejects simulated Numbers and does
not accept query parameters.

These values are account status observations. They do not establish terms
acceptance, recipient permission, template approval, message delivery, or a
right to send. Meta can deny a send despite a status value returned here.


## OpenAPI

````yaml api-reference/features/engage-at-scale-graph.json GET /graph/whatsapp/{version}/{wabaId}/marketing_messages/status
openapi: 3.0.3
info:
  title: Engage at scale Polymorfa Graph API methods
  version: 1.0.0
  description: Task-focused engage at scale methods exposed by the Polymorfa Graph API.
servers: []
security: []
paths:
  /graph/whatsapp/{version}/{wabaId}/marketing_messages/status:
    get:
      tags:
        - Marketing
      summary: Get marketing status
      description: >-
        **Protocols:** Meta Cloud API


        **Required scope:** `sessions:read`


        Reads Meta's WABA marketing status fields through a project-owned
        Official API Number. Values are returned without interpreting
        eligibility or terms acceptance. This is a Polymorfa WABA-scoped path,
        not a Meta edge.
      operationId: graphGetMarketingStatus
      parameters:
        - schema:
            type: string
            example: v26.0
          required: true
          name: version
          in: path
          description: Specifies version for this path parameter.
        - schema:
            type: string
            example: '200000000000001'
          required: true
          name: wabaId
          in: path
          description: Identifier for the waba.
      responses:
        '200':
          description: Raw Meta WABA status fields
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/graph__GraphMarketingStatusResponse'
          headers:
            X-RateLimit-Limit:
              $ref: '#/components/headers/graph__X-RateLimit-Limit'
            X-RateLimit-Remaining:
              $ref: '#/components/headers/graph__X-RateLimit-Remaining'
            X-RateLimit-Reset:
              $ref: '#/components/headers/graph__X-RateLimit-Reset'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/graph__GraphError'
          headers:
            X-RateLimit-Limit:
              $ref: '#/components/headers/graph__X-RateLimit-Limit'
            X-RateLimit-Remaining:
              $ref: '#/components/headers/graph__X-RateLimit-Remaining'
            X-RateLimit-Reset:
              $ref: '#/components/headers/graph__X-RateLimit-Reset'
        '401':
          description: Unauthenticated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/graph__GraphError'
          headers:
            X-RateLimit-Limit:
              $ref: '#/components/headers/graph__X-RateLimit-Limit'
            X-RateLimit-Remaining:
              $ref: '#/components/headers/graph__X-RateLimit-Remaining'
            X-RateLimit-Reset:
              $ref: '#/components/headers/graph__X-RateLimit-Reset'
        '403':
          description: Permission error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/graph__GraphError'
          headers:
            X-RateLimit-Limit:
              $ref: '#/components/headers/graph__X-RateLimit-Limit'
            X-RateLimit-Remaining:
              $ref: '#/components/headers/graph__X-RateLimit-Remaining'
            X-RateLimit-Reset:
              $ref: '#/components/headers/graph__X-RateLimit-Reset'
        '404':
          description: Object does not exist
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/graph__GraphError'
          headers:
            X-RateLimit-Limit:
              $ref: '#/components/headers/graph__X-RateLimit-Limit'
            X-RateLimit-Remaining:
              $ref: '#/components/headers/graph__X-RateLimit-Remaining'
            X-RateLimit-Reset:
              $ref: '#/components/headers/graph__X-RateLimit-Reset'
        '429':
          description: Rate limited
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/graph__GraphError'
          headers:
            X-RateLimit-Limit:
              $ref: '#/components/headers/graph__X-RateLimit-Limit'
            X-RateLimit-Remaining:
              $ref: '#/components/headers/graph__X-RateLimit-Remaining'
            X-RateLimit-Reset:
              $ref: '#/components/headers/graph__X-RateLimit-Reset'
        '500':
          description: Internal error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/graph__GraphError'
          headers:
            X-RateLimit-Limit:
              $ref: '#/components/headers/graph__X-RateLimit-Limit'
            X-RateLimit-Remaining:
              $ref: '#/components/headers/graph__X-RateLimit-Remaining'
            X-RateLimit-Reset:
              $ref: '#/components/headers/graph__X-RateLimit-Reset'
      security:
        - graph__BearerAuth: []
      servers:
        - url: https://api.polymorfa.com
components:
  schemas:
    graph__GraphMarketingStatusResponse:
      anyOf:
        - type: object
          properties:
            id:
              type: string
              description: Identifier for this resource.
            marketing_messages_lite_api_status:
              type: string
              description: Specifies marketing messages lite api status for this any of.
            marketing_messages_onboarding_status:
              type: string
              description: Specifies marketing messages onboarding status for this any of.
          required:
            - id
            - marketing_messages_lite_api_status
        - type: object
          properties:
            id:
              type: string
              description: Identifier for this resource.
            marketing_messages_lite_api_status:
              type: string
              description: Specifies marketing messages lite api status for this any of.
            marketing_messages_onboarding_status:
              type: string
              description: Specifies marketing messages onboarding status for this any of.
          required:
            - id
            - marketing_messages_onboarding_status
    graph__GraphError:
      type: object
      properties:
        error:
          type: object
          properties:
            message:
              type: string
              description: Human-readable message associated with this result.
            type:
              type: string
              description: Type discriminator for this object.
            code:
              type: number
              description: Stable machine-readable code for this result.
            error_subcode:
              type: number
              description: Machine-readable error subcode for this error.
            error_data:
              nullable: true
              description: |-
                Specifies error data for this error.

                <!-- polymorfa-input-table -->
                **Accepted alternatives**
                | Alternative | Accepted input |
                | --- | --- |
                | Alternative 1 | Any JSON value matching this alternative |
                | Alternative 2 | `null` |
            fbtrace_id:
              type: string
              description: Identifier for the fbtrace.
          required:
            - message
            - type
            - code
            - fbtrace_id
          description: Error details returned when the operation fails.
      required:
        - error
  headers:
    graph__X-RateLimit-Limit:
      description: >-
        Team request quota per rolling minute, when the per-team request limiter
        applies.
      schema:
        type: integer
        minimum: 1
    graph__X-RateLimit-Remaining:
      description: >-
        Requests left in the per-team quota; zero when this limiter rejects the
        request.
      schema:
        type: integer
        minimum: 0
    graph__X-RateLimit-Reset:
      description: >-
        Unix timestamp in seconds when the oldest counted request leaves the
        rolling window, when the per-team request limiter applies. Follow
        Retry-After on a rejected request.
      schema:
        type: integer
        minimum: 0
  securitySchemes:
    graph__BearerAuth:
      type: http
      scheme: bearer
      description: >-
        Polymorfa organization key (pmfa_ prefix) or project token (pmfa_pt_
        prefix). Client tokens are not accepted by Graph operations.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.