---
title: "Order one audit for a brand or person of the account: brand audit, personal audit, Wikipedia notability check, website analysis, Brand ORM status report or Personal ORM status report (reserves credits)"
method: POST
path: "/v1/audits"
tags: ["order_audit"]
---

# Order one audit for a brand or person of the account: brand audit, personal audit, Wikipedia notability check, website analysis, Brand ORM status report or Personal ORM status report (reserves credits)

`POST /v1/audits`

## Request

- Base URL: `https://api.buzzdealer.ai`
- URL: `https://api.buzzdealer.ai/v1/audits`
- Auth: HTTP bearer

Same behavior as the MCP tool order_audit.

## Request body

- object
  - `audit_type` 'brand_audit' | 'personal_audit' | 'wikipedia_notability' | 'website_analysis' | 'brand_orm' | 'personal_orm', required: brand_audit (sentiment, authority and discoverability scores for a brand), personal_audit (the same scores for a person), wikipedia_notability (whether the brand or person is likely notable enough for Wikipedia), website_analysis (an analysis report of one website), brand_orm (Brand ORM status report: where a brand's online reputation stands now, in search, AI answers and the press), personal_orm (Personal ORM status report: the same for a person)
  - `brand_id` string, uuid, required: The brand or person of this account the audit is about (listed in the dashboard under Brands); the report is kept with it. Items for an unverified brand wait for its verification before fulfilment
  - `name` string: The brand or person name to audit; defaults to the brand's name
  - `website` string: https link; for website_analysis the website to analyse (required when the brand has no website)
  - `relationship` 'myself' | 'my_company' | 'client': personal_audit only, required: who the person is to you: myself, my_company (someone in my company) or client (a client I represent)
  - `role` string: personal_audit only, optional: the person's role, for example "CEO, Acme"
  - `idempotency_key` string, required: A unique value per audit order; send it again only to retry the same order

## Response `200`

Success

- object

## Other responses

- `401`: Error
- `429`: Error
- `default`: Error

---

[API](https://skmtc.dev/buzzdealer/apis/buzz-dealer-ai-api.md) · [All operations](https://skmtc.dev/buzzdealer/apis/buzz-dealer-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/buzzdealer/apis/buzz-dealer-ai-api/revisions/e4865a268cd5?raw)