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

# Get usage

> Retrieve daily PaaS usage data for a company within a billing period.



## OpenAPI

````yaml https://api.sevalla.com/v2/openapi.json get /company/{id}/paas-usage
openapi: 3.1.0
info:
  title: Sevalla API docs
  version: 1.0.0
servers:
  - url: https://api.sevalla.com/v2
security:
  - bearerAuth: []
paths:
  /company/{id}/paas-usage:
    get:
      tags:
        - Company
      summary: Get usage
      description: Retrieve daily PaaS usage data for a company within a billing period.
      operationId: getUsageV2
      parameters:
        - schema:
            default: 0
            example: 0
            type: integer
            minimum: -5
            maximum: 0
          in: query
          name: period_offset
          required: false
          description: >-
            Period offset for usage data. 0 is the current period, -1 is the
            previous period, and so on.
        - schema:
            type: string
            format: uuid
            pattern: >-
              ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
            example: fb5e5168-4281-4bec-94c5-0d1584e9e657
          in: path
          name: id
          required: true
          description: Company identifier
      responses:
        '200':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  company:
                    type: object
                    properties:
                      paas_usage:
                        type: array
                        items:
                          type: object
                          properties:
                            id:
                              type: string
                              description: Unique identifier for the usage record
                              example: usage_12345
                            date:
                              type: number
                              description: Unix timestamp in milliseconds
                              example: 1738195200000
                            category:
                              type: string
                              enum:
                                - appCompute
                                - appStorage
                                - appBuild
                                - appBandwidth
                                - staticSiteBuild
                                - staticSiteBandwidth
                                - db
                                - objectStorage
                                - loadBalancer
                                - loadBalancerBandwidth
                              description: Resource usage type
                              example: appCompute
                            id_resource:
                              type: string
                              description: Resource identifier
                              example: fb5e5168-4281-4bec-94c5-0d1584e9e657
                            usage:
                              type: number
                              description: Usage amount
                              example: 24.5
                            cost:
                              type: number
                              description: Cost in USD
                              example: 12.75
                          required:
                            - id
                            - date
                            - category
                            - id_resource
                            - usage
                            - cost
                          additionalProperties: false
                    required:
                      - paas_usage
                    additionalProperties: false
                required:
                  - company
                additionalProperties: false
        '401':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Not found
                  status:
                    type: number
                    example: 404
                  data:
                    type: object
                    properties:
                      code:
                        description: Error tracking code for support reference
                        example: err_12345
                        type: string
                      message:
                        description: Instructions for the user
                        example: The requested resource was not found
                        type: string
                    additionalProperties: false
                required:
                  - message
                  - status
                additionalProperties: false
        '403':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Not found
                  status:
                    type: number
                    example: 404
                  data:
                    type: object
                    properties:
                      code:
                        description: Error tracking code for support reference
                        example: err_12345
                        type: string
                      message:
                        description: Instructions for the user
                        example: The requested resource was not found
                        type: string
                    additionalProperties: false
                required:
                  - message
                  - status
                additionalProperties: false
        '500':
          description: Default Response
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Not found
                  status:
                    type: number
                    example: 404
                  data:
                    type: object
                    properties:
                      code:
                        description: Error tracking code for support reference
                        example: err_12345
                        type: string
                      message:
                        description: Instructions for the user
                        example: The requested resource was not found
                        type: string
                    additionalProperties: false
                required:
                  - message
                  - status
                additionalProperties: false
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        API key authentication. Pass your API key as a Bearer token in the
        Authorization header.

````