# Create, list, retrieve, and delete a pricing intent.

Create, list, retrieve, and delete a pricing intent.

1. Create a pricing intent (MPA 5.2 template) with base, processor (card + ACH), and gateway fees. Requires the `Idempotency-Key` header. Returns 201 with the intent in `status: pendingReview`; capture its `id` for the follow-on steps.
 [createPricingIntent](/api/create-pricing-intent)
2. List the pricing intents associated with the ISV (paginated). Use this to discover a pricingIntentId when you do not already have one. All query parameters (`before`, `after`, `limit`) are optional; only `limit` is passed here.
 [listPricingIntents](/api/list-pricing-intents)
3. Retrieve a single pricing intent by id, including its fees and its approval `status` (`active`, `pendingReview`, or `rejected`).
 [getPricingIntent](/api/get-pricing-intent)
4. Permanently delete the pricing intent. Irreversible - it cannot be recovered or assigned to a boarding application afterwards. Does not affect merchants that are already boarded. Returns 204 No Content.
 [deletePricingIntent](/api/delete-pricing-intent)

## Workflow diagram

```mermaid
flowchart TD
  step0["1. create pricing intent · API"]
  step1["2. list pricing intents · API"]
  step0 --> step1
  step2["3. get pricing intent · API"]
  step1 --> step2
  step3["4. delete pricing intent · API"]
  step2 --> step3
```