---
title: "Listar uso"
url: "https://devcenter.stone.com.br/apis/v5-docs-legacy/versions/b9aaff36-6dcc-4353-8398-836d6c13dfa5/operations/listar-uso"
---

> Full API specification: https://devcenter.stone.com.br/apis/v5-docs-legacy/versions/b9aaff36-6dcc-4353-8398-836d6c13dfa5.md

# Listar uso

`GET` `/subscriptions/{subscription_id}/items/{item_id}/usages`

Operation ID: `listar-uso`

Este recurso permite listar os usos de um item de assinatura.

## Path parameters

- `subscription_id` (string, required) - Código da assinatura.<br>Formato: `sub_XXXXXXXXXXXXXXXX`.
- `item_id` (string, required) - Código do item da assinatura.<br>Formato: `si_XXXXXXXXXXXXXXXX`.

## Request body

Content types: `application/json`

## Responses

- `200` - 200
- `404` - 404

## OpenAPI definition

```yaml
openapi: 3.1.0
info:
  title: Pagar.me v5 API (Legado)
  version: 5.0.0
servers:
  - url: https://api.stone.com.br/core/v5
paths:
  /subscriptions/{subscription_id}/items/{item_id}/usages:
    get:
      summary: Listar uso
      description: Este recurso permite listar os usos de um item de assinatura.
      operationId: listar-uso
      parameters:
        - name: subscription_id
          in: path
          description: "Código da assinatura.<br>Formato: `sub_XXXXXXXXXXXXXXXX`."
          schema:
            type: string
          required: true
        - name: item_id
          in: path
          description: "Código do item da assinatura.<br>Formato: `si_XXXXXXXXXXXXXXXX`."
          schema:
            type: string
          required: true
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                code:
                  type: string
                  description: Código de identificação no sistema do cliente
                group:
                  type: string
                  description: Código de identificação do grupo no sistema do cliente
      responses:
        "200":
          description: "200"
          content:
            application/json:
              examples:
                Result:
                  value: |-
                    {
                      "data": [
                        {
                          "id": "usage_QV1gBLhalU35RNbx",
                          "quantity": 1,
                          "status": "deleted",
                          "used_at": "2017-04-04T18:21:50Z",
                          "created_at": "2017-04-04T18:21:50Z",
                          "deleted_at": "2017-04-04T18:25:08Z"
                        },
                        {
                          "id": "usage_73ybm1nCMfRVYdxA",
                          "quantity": 1,
                          "description": "Bola",
                          "status": "active",
                          "used_at": "2017-04-04T00:00:00Z",
                          "created_at": "2017-04-04T18:21:18Z"
                        }
                      ],
                      "paging": {
                        "total": 2
                      }
                    }
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          example: usage_QV1gBLhalU35RNbx
                        quantity:
                          type: integer
                          example: 1
                          default: 0
                        status:
                          type: string
                          example: deleted
                        used_at:
                          type: string
                          example: 2017-04-04T18:21:50Z
                        created_at:
                          type: string
                          example: 2017-04-04T18:21:50Z
                        deleted_at:
                          type: string
                          example: 2017-04-04T18:25:08Z
                  paging:
                    type: object
                    properties:
                      total:
                        type: integer
                        example: 2
                        default: 0
        "404":
          description: "404"
          content:
            application/json:
              examples:
                item not found:
                  value: |-
                    {
                        "message": "Item not found."
                    }
                subsciption not found:
                  value: |-
                    {
                      "message": "Subscription not found."
                    }
              schema:
                oneOf:
                  - title: item not found
                    type: object
                    properties:
                      message:
                        type: string
                        example: Item not found.
                  - title: subsciption not found
                    type: object
                    properties:
                      message:
                        type: string
                        example: Subscription not found.
      deprecated: false
security:
  - sec0: []
components:
  securitySchemes:
    sec0:
      type: http
      scheme: basic
```