Media2URL Developer Platform REST API
    • Media2URL Developer Platform - Overview & API Documentation
    • Retrieve Account & API Usage
      GET
    • Request Direct R2 Upload URL
      POST
    • Finalize Upload & Promote Asset
      POST
    • Check for Duplicate Asset
      POST
    • List Assets
      GET
    • Get Asset Details
      GET
    • Delete Asset
      DELETE
    • Presign Replacement Upload
      POST
    • Finalize Asset Replacement
      POST
    • List Asset Version History
      GET
    • List Folders
      GET
    • Create Folder
      POST
    • Import Remote URL
      POST
    • Get Job Status
      GET
    • Schemas
      • CredentialSurface
      • ProblemDetails
      • UsageResponse
      • AutomationAccountCapabilities
      • PresignUploadRequest
      • PresignUploadResponse
      • FinalizeUploadRequest
      • ReplacePresignRequest
      • AssetResource
      • CheckDuplicateRequest
      • CheckDuplicateResponse
      • PaginatedAssetList
      • VersionHistoryResponse
      • FolderResource
      • FolderListResponse
      • CreateFolderRequest
      • ImportRequest
      • ImportResponse
      • JobResource

      Retrieve Account & API Usage

      GET
      /usage
      Returns authoritative usage metrics for storage, bandwidth, and monthly upload counts.

      Request

      Authorization
      Bearer Token
      Provide your bearer token in the
      Authorization
      header when making requests to protected resources.
      Example:
      Authorization: Bearer ********************
      or

      Responses

      🟢200
      application/json
      Authoritative usage metrics
      Bodyapplication/json

      🟠401Unauthorized
      🟠403Forbidden
      🟠429RateLimited
      Request Request Example
      Shell
      JavaScript
      Java
      Swift
      curl --location '/usage' \
      --header 'Authorization: Bearer <token>'
      Response Response Example
      200 - Example 1
      {
          "api": {
              "version": "v1",
              "access": true
          },
          "requests": {
              "used": 420,
              "limit": 100000,
              "reset_at": "2019-08-24T14:15:22.123Z"
          },
          "storage": {
              "used_bytes": 1073741824,
              "limit_bytes": 268435456000
          },
          "bandwidth": {
              "used_bytes": 5368709120,
              "limit_bytes": 3221225472000
          },
          "account": {
              "plan": "string",
              "capabilities": {
                  "allowed_formats": [
                      "string"
                  ],
                  "temporary_publish": true,
                  "persistent_publish": true,
                  "replace": true
              },
              "trial": {
                  "lifetime_limit": 0,
                  "lifetime_used": 0,
                  "remaining": 0,
                  "retention_seconds": 0
              },
              "max_file_size_bytes": 0,
              "persistent": true,
              "replace": true
          }
      }
      Modified at 2026-10-11 18:32:15
      Previous
      Media2URL Developer Platform - Overview & API Documentation
      Next
      Request Direct R2 Upload URL
      Built with