> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getmeasure.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Apply Credit to Open Invoices

> Apply a credit to one or more open invoices. If no invoice UUIDs are provided, the credit is applied to open invoices oldest-first until exhausted.



## OpenAPI

````yaml https://api.getmeasure.com/api/v1/docs/api_spec.json post /companies/{company_id}/credits/{id}/apply_to_open_invoices
openapi: 3.1.0
info:
  title: Measure API
  description: APIs to communicate with Measure
  version: 1.0.0
servers:
  - url: https://api.getmeasure.com/api/v1
security: []
paths:
  /companies/{company_id}/credits/{id}/apply_to_open_invoices:
    post:
      tags:
        - Credits
      summary: Apply Credit to Open Invoices
      description: >-
        Apply a credit to one or more open invoices. If no invoice UUIDs are
        provided, the credit is applied to open invoices oldest-first until
        exhausted.
      operationId: Apply_Credit_to_Open_Invoices
      parameters:
        - name: company_id
          in: path
          description: 'The company ID with the prefix ''cmp_''. '
          required: true
          schema:
            description: 'The company ID with the prefix ''cmp_''. '
            type: string
        - name: id
          in: path
          description: The resource ID
          required: true
          schema:
            description: The resource ID
            type: string
        - name: Idempotency-Key
          in: header
          description: >-
            The idempotency key that will be used to ensure the request is only
            performed once
          schema:
            description: >-
              The idempotency key that will be used to ensure the request is
              only performed once
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RequestApplyCreditToOpenInvoicesRequest'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseCreditRepresentation'
      deprecated: false
      security:
        - apiKey:
            - ''
components:
  schemas:
    RequestApplyCreditToOpenInvoicesRequest:
      properties:
        invoice_uuids:
          description: >-
            The invoice UUIDs to apply the credits to. If not provided, we apply
            the credits to open invoices one by one till the credits run out or
            there are no more open invoices. We start by applying the invoices
            to the oldest invoice.
          items:
            type: string
          type:
            - array
            - 'null'
      type: object
    ResponseCreditRepresentation:
      properties:
        amount:
          $ref: '#/components/schemas/ModelAmount'
        coupon_id:
          type:
            - 'null'
            - string
        created_at:
          format: date-time
          type: string
        customer_id:
          type: string
        expiration_date:
          format: date-time
          type:
            - 'null'
            - string
        id:
          type: string
        import_created_at_ref:
          format: date-time
          type:
            - 'null'
            - string
        import_ref:
          type:
            - 'null'
            - string
        imported_from:
          type:
            - 'null'
            - string
        issued_amount:
          $ref: '#/components/schemas/ModelAmount'
        issued_units:
          format: double
          type: number
        item:
          $ref: '#/components/schemas/ResponseBillableItemRepresentation'
        item_id:
          type:
            - 'null'
            - string
        metric_record_id:
          type:
            - 'null'
            - string
        name:
          type: string
        one_time_billable_id:
          type:
            - 'null'
            - string
        proration_date:
          format: date-time
          type:
            - 'null'
            - string
        restricted_product_ids:
          items:
            type: string
          type:
            - array
            - 'null'
        state:
          type: string
        subscription_id:
          type:
            - 'null'
            - string
        type:
          type: string
        units:
          format: double
          type: number
      type: object
    ModelAmount:
      description: The amount which has value in cents and a currency
      properties:
        currency:
          type: string
        value_in_cents:
          format: int64
          type: integer
      type: object
    ResponseBillableItemRepresentation:
      properties:
        company_id:
          description: The company ID for the billable item
          type: string
        created_at:
          description: The date the billable item was created
          format: date-time
          type: string
        description:
          description: Any description attached to the billable item
          type: string
        display_type:
          description: >-
            The display type of the billable item which can be one of UNITS,
            AMOUNT, THOUSAND_UNITS, MILLION_UNITS
          type: string
        editable:
          description: Whether the billable item can be further edited
          type: boolean
        external_name:
          description: The public name of the billable item
          type: string
        id:
          description: The ID of the billable item in Measure
          type: string
        name:
          description: The name of the billable item
          type: string
        standard:
          description: >-
            Whether this is a standard billable item in Measure or a custom
            billable item
          type: boolean
        type:
          description: >-
            The type of the billable item which can be one of CUSTOM_USAGE or
            CUSTOM_OBJ, based on usage-based item or object-based item
          type: string
        updated_at:
          description: The date the billable item was last updated
          format: date-time
          type: string
      type: object
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer

````