---
search:
  tags:
    - Customer Queries
    - POST
seo:
  description: >-
    Sets the customer query to successful or failed and… Reference for the POST
    /api/v1/partners/customer-queries/status endpoint in the Just-tap Partner
    API.
sidebar:
  label: Report the terminal result
  badge: POST
title: Report the terminal result
type: openapi-operation
---
Sets the customer query to successful or failed and stores the mobile money provider's externalId. Send the query id, your referenceId, or both when they refer to the same query. Sending the same status and provider id again returns the current record.

`POST /api/v1/partners/customer-queries/status`

**Request body** (`application/json`, required)

- `id` (string<uuid>) — The customer query id.
- `referenceId` (string) — Your reference for the query.
- `externalId` (string, required) — The mobile money provider's id for this transaction.
- `status` (string, required) — How the terminal transaction ended.

Request body example:

```json
{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "referenceId": "string",
  "externalId": "string",
  "status": "successful"
}
```

**Responses**

- `200` — The customer query, with the terminal status applied.
- `400` — The body did not include a query id or a referenceId.
- `401` — The API key is missing, invalid, revoked, or expired.
- `403` — This API key cannot run customer queries.
- `404` — No customer query with those identifiers belongs to this API key.
- `422` — The request failed validation.
- `500` — Something went wrong on our side.

Response example, 200:

```json
{
  "data": {
    "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
    "partner": {
      "partnerId": "bf408d53-df49-40a6-8455-a34bd4360901",
      "partnerName": "string"
    },
    "customer": {
      "firstName": "string",
      "lastName": "string"
    },
    "tag": {
      "tagId": "string",
      "tagNumber": "string",
      "mobileNumbers": [
        {
          "operator": "airtel_money",
          "mobileNumber": "string",
          "status": "string"
        }
      ],
      "status": "string"
    },
    "transaction": {
      "merchantId": "string",
      "merchantName": "string",
      "terminalId": "string",
      "referenceId": "string",
      "externalId": "string",
      "currency": "string",
      "amount": 0,
      "serviceCharge": 0,
      "totalAmount": 0,
      "status": "pending"
    },
    "createdAt": "2019-08-24T14:15:22Z",
    "updatedAt": "2019-08-24T14:15:22Z"
  }
}
```