# company.verification_updated

`POST company.verification_updated`

The company's verification status changed, or a change made after verification was approved or declined.


```yaml
security: []
parameters:
  - name: Beauty-Router-Signature
    in: header
    required: true
    description: >
      `t=<unix seconds>,v1=<hex HMAC-SHA256 of "<t>.<raw body>" with your
      webhook secret>`. While several secrets are live,

      the header has one `v1` per live secret, and you accept the event if any
      `v1` matches. Reject a request when `t` is

      more than 5 minutes old or more than 5 minutes in the future. See
      [Webhooks](/webhooks/).
    schema:
      type: string
    example: t=1793200437,v1=5f2b8c0e4d6a7b1c9e3f0a2d4b6c8e1f3a5b7d9c0e2f4a6b8d1c3e5f7a9b0c2d
requestBody:
  required: true
  content:
    application/json:
      schema:
        allOf:
          - type: object
            description: Every webhook event has these fields, plus `type` and `data`.
            required:
              - id
              - type
              - createdAt
              - data
            properties:
              id:
                type: string
                description: The event ID. Skip an event you already handled.
                examples:
                  - event-7Zx1cVb9Nm
              createdAt:
                type: string
                format: date-time
          - type: object
            properties:
              type:
                type: string
                const: company.verification_updated
              data:
                type: object
                required:
                  - companyId
                  - verificationStatus
                  - pendingChanges
                properties:
                  companyId:
                    type: string
                    examples:
                      - loc-7Hk2pQx9Lm
                  verificationStatus:
                    type: string
                    description: >
                      `unverified`: not submitted yet. `in_review`: Beauty
                      Router is reviewing the company. `prequalified`: the
                      initial

                      check passed, and the detailed verification is still
                      pending. The company can order, its orders wait until that

                      verification ends, and no charge happens until then.
                      `verified`: the company passed the review.

                      `declined`: the company did not pass the review.
                    enum:
                      - unverified
                      - in_review
                      - prequalified
                      - verified
                      - declined
                  pendingChanges:
                    oneOf:
                      - type: object
                        description: >
                          New values of an `in_review`, `prequalified`, or
                          `verified` company that wait for review. `null` when
                          no change

                          waits for review.
                        properties:
                          businessType:
                            type: string
                            description: >
                              `salon` for a salon or spa, `professional` for an
                              individual licensed professional, `store` for a
                              beauty supply

                              store. Beauty Router does not support stores yet,
                              so verification for a `store` always fails.
                            enum:
                              - salon
                              - professional
                              - store
                          displayName:
                            type: string
                          legalName:
                            type: string
                          ein:
                            type: string
                            pattern: ^[0-9]{9}$
                      - type: "null"
      examples:
        Company verified:
          value:
            id: event-2Rb6nMq8Wc
            type: company.verification_updated
            createdAt: 2026-10-27T13:20:11Z
            data:
              companyId: loc-7Hk2pQx9Lm
              verificationStatus: verified
              pendingChanges: null
responses:
  2XX:
    description: >
      Respond with a `2xx` status within 10 seconds. Otherwise Beauty Router
      retries with backoff for up to 24 hours.

      Delivery is at least once, so skip an event `id` you already handled.
```