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

# Get Webhook

> One webhook registration

A webhook of another workspace answers `404`, like a missing one.

## Permissions

The API key needs the **WhatsApp** permission.


## OpenAPI

````yaml get /public/v1/webhooks/registrations/{id}
openapi: 3.1.0
info:
  title: API Documentation
  description: Documentation for transactional and subscribe APIs
  version: 1.0.0
servers:
  - url: https://app.minimo.it
security:
  - bearerAuth: []
paths:
  /public/v1/webhooks/registrations/{id}:
    servers:
      - url: https://api.minimo.it
    get:
      summary: Get a webhook
      description: One webhook registration.
      operationId: getWebhookRegistration
      parameters:
        - name: id
          in: path
          required: true
          description: The webhook `id` from Register Webhook or List Webhooks.
          schema:
            type: integer
      responses:
        '200':
          description: The webhook
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/WebhookRegistration'
              example:
                data:
                  id: 42
                  name: Support bot
                  url: https://bot.example.com/minimo/webhook
                  events:
                    - whatsapp.message.received
                    - whatsapp.message.status
                  status: active
                  method: POST
                  headers: {}
                  hasSecret: true
                  created: '2026-11-13T10:00:00.000Z'
        '401':
          description: >-
            Missing or invalid API key, or a key without the `WhatsApp`
            permission.
        '404':
          description: No webhook with this id in your workspace.
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: string
                    example: FAIL
                  message:
                    type: string
      security:
        - bearerAuth: []
      x-codeSamples:
        - label: CLI
          lang: cURL
          source: |-
            curl --request GET \
              --url 'https://api.minimo.it/public/v1/webhooks/registrations/42' \
              --header 'Authorization: Bearer {{BEARER_TOKEN}}'
        - lang: JavaScript
          source: >-
            const res = await
            fetch('https://api.minimo.it/public/v1/webhooks/registrations/42', {
              method: 'GET',
              headers: {
                'Authorization': 'Bearer {{BEARER_TOKEN}}',
              },
            });

            const { data } = await res.json();

            console.log(data);
        - lang: Python
          source: |-
            import requests

            res = requests.get(
                'https://api.minimo.it/public/v1/webhooks/registrations/42',
                headers={'Authorization': 'Bearer {{BEARER_TOKEN}}'},
            )
            print(res.json())
components:
  schemas:
    WebhookRegistration:
      type: object
      description: >-
        A webhook registration. The `secret` is never returned: `hasSecret`
        tells you one is set.
      properties:
        id:
          type: integer
          example: 42
        name:
          type: string
          example: Support bot
        url:
          type: string
          example: https://bot.example.com/minimo/webhook
        events:
          type: array
          items:
            type: string
            enum:
              - whatsapp.message.received
              - whatsapp.message.status
        status:
          type: string
          enum:
            - active
            - inactive
        method:
          type: string
          enum:
            - POST
            - GET
        headers:
          type: object
          additionalProperties:
            type: string
          description: >-
            Static headers sent on every delivery, as `{ "Header-Name": "value"
            }`.
        hasSecret:
          type: boolean
        created:
          type: string
          format: date-time
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: mn-API_CLIENT_ID-API_KEY

````

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