> ## Documentation Index > Fetch the complete documentation index at: https://docs.interchange.io/llms.txt > Use this file to discover all available pages before exploring further. # Get a single media-buy approval entry > Fetch one approval-queue entry by the buyer's `media_buy_id`. Returns the raw submitted payload alongside the current status and any operator decision. ## OpenAPI ````yaml /v2/storefront-api-v2.yaml get /media-buy-approvals/{mediaBuyId} openapi: 3.0.0 info: title: Scope3 Storefront API version: 2.0.0 description: |- REST API for partners to manage storefronts, inventory sources, and billing. ## Authentication All endpoints require a Bearer token in the Authorization header: ``` Authorization: Bearer your-api-key ``` ## Base URL `https://api.interchange.io/api/v2/storefront` ## For AI Agents AI agents can use the MCP endpoint at `/mcp/v2/storefront` with three tools: - `initialize`: Start an MCP session - `api_call`: Make REST API calls - `ask_about_capability`: Learn about API features servers: - url: https://api.interchange.io/api/v2/storefront description: Production server security: [] tags: - name: Account description: Account management, service tokens, and preferences - name: Storefront description: Manage storefront and inventory sources - name: Storefront Agents description: List and manage registered sales, signals, and outcomes agents - name: Storefront Activity description: Audit log of configuration and inventory changes on the storefront - name: Storefront Billing description: Payout bank details and billing configuration for storefronts - name: AI Usage description: Storefront AI token usage visibility by model - name: MCP description: Model Context Protocol endpoints paths: /media-buy-approvals/{mediaBuyId}: get: tags: - Storefront summary: Get a single media-buy approval entry description: >- Fetch one approval-queue entry by the buyer's `media_buy_id`. Returns the raw submitted payload alongside the current status and any operator decision. operationId: getPendingMediaBuy parameters: - in: path name: mediaBuyId schema: description: Buyer-supplied media buy identifier (AdCP `media_buy_id`). type: string minLength: 1 required: true description: Buyer-supplied media buy identifier (AdCP `media_buy_id`). responses: '200': description: Get a single media-buy approval entry content: application/json: schema: $ref: '#/components/schemas/PendingMediaBuyResponse' '400': description: Bad request content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - bearerAuth: [] components: schemas: PendingMediaBuyResponse: description: A single pending media-buy entry on a storefront approval queue. type: object properties: id: description: Surrogate id of the approval row (BIGINT serialized as string). example: '42' type: string kind: description: >- Approval workstream kind. `create` is an initial create_media_buy approval; `update` is a material update_media_buy approval for an already-created buy. default: create type: string enum: - create - update storefrontId: description: >- Storefront the pending buy was submitted to (BIGINT serialized as string). example: '1234' type: string mediaBuyId: description: >- Buyer-supplied media buy identifier (AdCP `media_buy_id`). Unique per storefront — re-submitting the same id is idempotent. type: string buyerCustomerId: description: Customer id of the buyer who submitted the media buy. type: integer minimum: -9007199254740991 maximum: 9007199254740991 submittedPayload: description: >- Raw AdCP `create_media_buy` payload as the buyer submitted it, with buyer webhook credentials (`push_notification_config` / `pushNotificationConfig`) removed before it reaches operator-facing responses. Not normalized — the operator UI renders a summary directly from this object. status: description: >- Lifecycle state. `pending` until the operator decides; `approved` once the operator accepts (forwarding upstream happens out-of-band and is reflected by `forwardedAt`); `rejected` when the operator declines; `revoked` for buyer- or system-initiated cancellation after a decision. type: string enum: - pending - approved - rejected - revoked reviewedBy: description: >- User id of the operator who recorded the decision (BIGINT serialized as string). Null while pending. nullable: true type: string reviewedAt: description: >- When the operator decision was recorded (ISO 8601). Null while pending. nullable: true type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ reviewerNotes: description: Operator note attached to the decision. Null while pending. nullable: true type: string forwardedAt: description: >- When the approved buy was successfully forwarded to the underlying sales-agent (ISO 8601). Null until forwarding succeeds; an approved row with a null `forwardedAt` indicates the upstream forward has not happened yet. nullable: true type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ createdAt: description: When the buyer submitted the media buy (ISO 8601). type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ updatedAt: description: >- When the row was last modified — submission, decision, or forwarding stamp (ISO 8601). type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ required: - id - kind - storefrontId - mediaBuyId - buyerCustomerId - submittedPayload - status - reviewedBy - reviewedAt - reviewerNotes - forwardedAt - createdAt - updatedAt additionalProperties: false ErrorResponse: description: Standard error response type: object properties: data: type: string nullable: true enum: - null error: $ref: '#/components/schemas/ApiError' required: - data - error additionalProperties: false ApiError: description: Structured error object type: object properties: code: description: Machine-readable error code type: string message: description: Human-readable error message type: string field: description: Field path associated with the error type: string details: description: Additional error context type: object additionalProperties: {} required: - code - message additionalProperties: false securitySchemes: bearerAuth: type: http scheme: bearer description: API key or access token ````