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

# Get Business Profile

> Returns the WhatsApp business profile of an application: about, address, description, contact email, profile picture, websites, and category.

Read fresh directly from Meta, with no caching. The `app_id` is verified to belong to the organization before the request is made.

Every field is optional — fields that are not set on the profile are dropped from the response, so an empty profile returns `{ "data": {}, "isSuccess": true }`.



## OpenAPI

````yaml /public-openapi.json get /wa/{app_id}/profile
openapi: 3.0.3
info:
  title: Connexease Public API
  version: 1.0.0
  description: >-
    Panel-independent API for managing WhatsApp Business operations from your
    own servers.


    Every endpoint is scoped to the organization resolved from your secret key.
    Read endpoints are uncached and proxy straight to the source.


    **On-premises installations** are served from your own domain with an extra
    `/public` segment: `https://{your_domain}/public/api/v1/...`.
    Authentication, bodies, responses, and error codes are identical.
servers:
  - url: https://public-api.gateway.connexease.com/api/v1
    description: Production
security:
  - secretKey: []
tags:
  - name: Analytics
    description: Organization-wide message volume.
  - name: Application
    description: The WhatsApp business profile linked to an application.
  - name: Template
    description: >-
      The full template lifecycle: create, list, inspect, update, delete, and
      measure.
  - name: Media
    description: >-
      Uploads that produce the single-use handle for template headers and the
      profile picture.
  - name: Developers
    description: Webhook configuration and API keys.
paths:
  /wa/{app_id}/profile:
    get:
      tags:
        - Application
      summary: Get Business Profile
      description: >-
        Returns the WhatsApp business profile of an application: about, address,
        description, contact email, profile picture, websites, and category.


        Read fresh directly from Meta, with no caching. The `app_id` is verified
        to belong to the organization before the request is made.


        Every field is optional — fields that are not set on the profile are
        dropped from the response, so an empty profile returns `{ "data": {},
        "isSuccess": true }`.
      operationId: getBusinessProfile
      parameters:
        - $ref: '#/components/parameters/AppId'
      responses:
        '200':
          description: The business profile.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/BusinessProfile'
                  isSuccess:
                    type: boolean
                    enum:
                      - true
              example:
                data:
                  about: Open 09:00-18:00
                  address: Levent, Istanbul
                  description: We sell quality goods.
                  email: hello@acme.com
                  profilePictureUrl: https://cdn.example.com/acme/logo.png
                  websites:
                    - https://acme.com
                    - https://shop.acme.com
                  category: RETAIL
                isSuccess: true
        '400':
          description: Meta rejected a parameter (`META_033`).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '401':
          description: >-
            Secret key missing or invalid (`ORGANIZATION_SECRET_010` / `011`),
            or Meta access token expired or invalid (`META_030`).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '403':
          description: Meta permission denied (`META_031`).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '404':
          $ref: '#/components/responses/AppNotFound'
        '429':
          description: Meta rate limit (`META_032`).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
        '502':
          description: Could not fetch the profile from Meta (`META_001`).
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorEnvelope'
components:
  parameters:
    AppId:
      name: app_id
      in: path
      required: true
      description: >-
        Application ID. Must belong to the organization resolved from your
        secret key, otherwise the request returns `404` with `APPLICATION_004`.
      schema:
        type: string
        example: app_7poyXj8GXuv76e
  schemas:
    BusinessProfile:
      type: object
      description: >-
        Every field is optional. Fields not set on the profile are dropped from
        the response.
      properties:
        about:
          type: string
          maxLength: 139
        address:
          type: string
        description:
          type: string
        email:
          type: string
          format: email
        profilePictureUrl:
          type: string
          format: uri
          readOnly: true
          description: >-
            Read-only. Set the picture through `profilePictureReference` on the
            update call.
        websites:
          type: array
          maxItems: 2
          items:
            type: string
            format: uri
        category:
          $ref: '#/components/schemas/BusinessProfileCategory'
    ErrorEnvelope:
      type: object
      description: >-
        Every failure shares this shape. `description` already has any `params`
        interpolated into it.
      properties:
        isSuccess:
          type: boolean
          enum:
            - false
        errors:
          type: object
          properties:
            code:
              type: string
              description: >-
                `VAL_*`, `WA_*`, `META_*`, `APPLICATION_*`,
                `ORGANIZATION_SECRET_*`, `REQ_001`, or `SYS_001`.
              example: META_075
            group:
              type: string
              enum:
                - VALIDATION
                - NOT_FOUND
                - CONFLICT
                - AUTHENTICATION
                - NOT_ALLOWED
                - LIMIT_EXCEEDED
                - SERVICE_UNAVAILABLE
                - SYSTEM
            description:
              type: string
              example: Template with 0000000000 not found in Meta.
            params:
              type: object
              additionalProperties: true
              description: >-
                Raw values interpolated into `description`. Present only on
                parametric messages.
            fields:
              type: object
              description: >-
                Field-level validation errors only. Field name (dot-joined for
                nested fields, list indices omitted) to its own `code` /
                `description` / `params`.
              additionalProperties:
                type: object
                properties:
                  code:
                    type: string
                  description:
                    type: string
                  params:
                    type: object
                    additionalProperties: true
          required:
            - code
            - group
            - description
      required:
        - isSuccess
        - errors
    BusinessProfileCategory:
      type: string
      description: Business category. On Meta's side this is the `vertical` field.
      enum:
        - UNDEFINED
        - OTHER
        - ALCOHOL
        - AUTO
        - BEAUTY
        - APPAREL
        - EDU
        - ENTERTAIN
        - EVENT_PLAN
        - FINANCE
        - GROCERY
        - GOVT
        - HOTEL
        - HEALTH
        - NONPROFIT
        - ONLINE_GAMBLING
        - OTC_DRUGS
        - PHYSICAL_GAMBLING
        - PROF_SERVICES
        - RETAIL
        - TRAVEL
        - RESTAURANT
        - NOT_A_BIZ
  responses:
    AppNotFound:
      description: '`app_id` does not belong to the organization (`APPLICATION_004`).'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorEnvelope'
  securitySchemes:
    secretKey:
      type: http
      scheme: bearer
      description: >-
        Secret key in `Bearer sk_...` format. Server-to-server only — never
        embed it in a browser or mobile client. The organization is resolved
        from the key, so `organization_id` is never passed explicitly.

````