> ## Documentation Index > Fetch the complete documentation index at: https://docs.nebius.com/llms.txt > Use this file to discover all available pages before exploring further. # List > Lists one-time exports for a given contract. ## OpenAPI ````yaml https://api.nebius.cloud/openapi.json get /billing/v1alpha1/one-time-exports openapi: 3.0.3 info: title: Nebius API version: version not set servers: - url: https://api.nebius.cloud security: - bearerAuth: [] tags: - name: nebius.ai.v1.EndpointService - name: nebius.ai.v1.JobService - name: nebius.applications.v1alpha1.K8sReleaseService - name: nebius.audit.v2.AuditEventExportService - name: nebius.audit.v2.AuditEventService - name: nebius.billing.v1.CalculatorService - name: nebius.billing.v1alpha1.CalculatorService - name: nebius.billing.v1alpha1.OneTimeExportService - name: nebius.capacity.v1.CapacityAllowanceService - name: nebius.capacity.v1.CapacityBlockGroupService - name: nebius.capacity.v1.CapacityIntervalService - name: nebius.capacity.v1.ResourceAdviceService - name: nebius.compute.v1.DiskService - name: nebius.compute.v1.DiskSnapshotService - name: nebius.compute.v1.FilesystemService - name: nebius.compute.v1.GpuClusterService - name: nebius.compute.v1.ImageService - name: nebius.compute.v1.InstanceService - name: nebius.compute.v1.MaintenanceService - name: nebius.compute.v1.NVLInstanceGroupService - name: nebius.compute.v1.NodeService - name: nebius.compute.v1.PlatformService - name: nebius.dns.v1.RecordService - name: nebius.dns.v1.ZoneService - name: nebius.iam.v1.AccessKeyService - name: nebius.iam.v1.AccessPermitService - name: nebius.iam.v1.AuthPublicKeyService - name: nebius.iam.v1.FederatedCredentialsService - name: nebius.iam.v1.FederationCertificateService - name: nebius.iam.v1.FederationService - name: nebius.iam.v1.GroupMembershipService - name: nebius.iam.v1.GroupService - name: nebius.iam.v1.InvitationService - name: nebius.iam.v1.ProfileService - name: nebius.iam.v1.ProjectService - name: nebius.iam.v1.ServiceAccountService - name: nebius.iam.v1.SessionManagementService - name: nebius.iam.v1.StaticKeyService - name: nebius.iam.v1.TenantService - name: nebius.iam.v1.TenantUserAccountService - name: nebius.iam.v1.TenantUserAccountWithAttributesService - name: nebius.iam.v2.AccessKeyService - name: nebius.iam.v2.ProjectService - name: nebius.iam.v2.TenantService - name: nebius.kms.v1.AsymmetricCryptoService - name: nebius.kms.v1.AsymmetricKeyService - name: nebius.kms.v1.SymmetricCryptoService - name: nebius.kms.v1.SymmetricKeyService - name: nebius.logging.agentmanager.v1.VersionService - name: nebius.logging.v1.LogExportService - name: nebius.maintenance.v1alpha1.MaintenanceService - name: nebius.mk8s.v1.ClusterService - name: nebius.mk8s.v1.NodeGroupService - name: nebius.mk8s.v1alpha1.ClusterService - name: nebius.mk8s.v1alpha1.NodeGroupService - name: nebius.msp.mlflow.v1alpha1.ClusterService - name: nebius.msp.postgresql.v1alpha1.BackupService - name: nebius.msp.postgresql.v1alpha1.ClusterService - name: nebius.mysterybox.v1.PayloadService - name: nebius.mysterybox.v1.SecretService - name: nebius.mysterybox.v1.SecretVersionService - name: nebius.quotas.v1.QuotaAllowanceService - name: nebius.registry.v1.ArtifactService - name: nebius.registry.v1.RegistryService - name: nebius.storage.v1.BucketService - name: nebius.storage.v1.TransferService - name: nebius.storage.v1alpha1.TransferService - name: nebius.tunnel.v1.TunnelService - name: nebius.vpc.v1.AllocationService - name: nebius.vpc.v1.NetworkService - name: nebius.vpc.v1.PoolService - name: nebius.vpc.v1.RouteService - name: nebius.vpc.v1.RouteTableService - name: nebius.vpc.v1.SecurityGroupService - name: nebius.vpc.v1.SecurityRuleService - name: nebius.vpc.v1.SubnetService - name: nebius.vpc.v1.TargetGroupService - name: nebius.vpc.v1alpha1.AllocationService - name: nebius.vpc.v1alpha1.NetworkService - name: nebius.vpc.v1alpha1.PoolService - name: nebius.vpc.v1alpha1.ScopeService - name: nebius.vpc.v1alpha1.SubnetService paths: /billing/v1alpha1/one-time-exports: get: tags: - nebius.billing.v1alpha1.OneTimeExportService summary: List description: Lists one-time exports for a given contract. operationId: OneTimeExportService_List parameters: - description: Parent contract ID for which to list one-time exports. in: query name: parentId required: true schema: type: string - description: Maximum number of items to return per page. in: query name: pageSize schema: format: int64 type: string - description: Token for retrieving the next page of results. in: query name: pageToken schema: type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/v1alpha1ListOneTimeExportsResponse' description: A successful response. components: schemas: v1alpha1ListOneTimeExportsResponse: properties: items: description: List of one-time exports for the specified contract. items: $ref: '#/components/schemas/v1alpha1OneTimeExport' type: array nextPageToken: description: >- Token for retrieving the next page of results. Empty if no more pages. type: string type: object v1alpha1OneTimeExport: description: |- One-time export of billing reports as a downloadable archive. Creates a .tar.gz archive of FOCUS billing data for the requested period and provides a presigned download URL. properties: metadata: $ref: '#/components/schemas/commonV1ResourceMetadata' spec: $ref: '#/components/schemas/v1alpha1OneTimeExportSpec' status: $ref: '#/components/schemas/v1alpha1OneTimeExportStatus' type: object commonV1ResourceMetadata: description: Common resource metadata. properties: createdAt: description: Timestamp indicating when the resource was created. format: date-time readOnly: true type: string id: description: Identifier for the resource, unique for its resource type. type: string labels: additionalProperties: type: string description: Labels associated with the resource. type: object name: description: Human readable name for the resource. type: string parentId: description: Identifier of the parent resource to which the resource belongs. type: string resourceVersion: description: >- Version of the resource for safe concurrent modifications and consistent reads. Positive and monotonically increases on each resource spec change (but *not* on each change of the resource's container(s) or status). Service allows zero value or current. format: int64 type: string updatedAt: description: Timestamp indicating when the resource was last updated. format: date-time readOnly: true type: string required: - parentId type: object v1alpha1OneTimeExportSpec: description: Specification for one-time billing report export. properties: endPeriod: description: |- The last billing period to include in the export (inclusive). Example: "2025-06". type: string format: $ref: '#/components/schemas/v1alpha1ExportFormat' startPeriod: description: |- The first billing period to include in the export (inclusive). Example: "2025-04". type: string required: - format - startPeriod - endPeriod type: object v1alpha1OneTimeExportStatus: description: Status information for one-time export. properties: downloadUrl: description: >- Presigned download URL for the archive. Populated only when state is DONE. Each Get request generates a fresh URL. type: string expiresAt: description: Timestamp when this export expires. format: date-time type: string state: $ref: '#/components/schemas/v1alpha1OneTimeExportState' stateDetails: $ref: '#/components/schemas/v1alpha1OneTimeExportStateDetails' type: object v1alpha1ExportFormat: default: EXPORT_FORMAT_UNSPECIFIED description: >- Supported export formats for billing reports. - EXPORT_FORMAT_FOCUS_1_2_CSV: FOCUS (FinOps Open Cost and Usage Specification) v1.2 CSV format. See: https://focus.finops.org/focus-specification/v1-2/ - EXPORT_FORMAT_CONSUMPTION_BREAKDOWN_PDF: Consumption Breakdown PDF format. Single-period human-readable cost breakdown report exported as a PDF file. enum: - EXPORT_FORMAT_UNSPECIFIED - EXPORT_FORMAT_FOCUS_1_2_CSV - EXPORT_FORMAT_CONSUMPTION_BREAKDOWN_PDF type: string v1alpha1OneTimeExportState: default: ONE_TIME_EXPORT_STATE_UNSPECIFIED description: |- Lifecycle states for one-time export. - ONE_TIME_EXPORT_STATE_SCHEDULED: Export has been created and is scheduled for processing. - ONE_TIME_EXPORT_STATE_RUNNING: Export is in progress. - ONE_TIME_EXPORT_STATE_SUCCESS: Export completed successfully. Download URL is available. - ONE_TIME_EXPORT_STATE_FAILED: Export failed. See error field for details. - ONE_TIME_EXPORT_STATE_ARCHIVED: Export has been archived and the archive is no longer available for download. enum: - ONE_TIME_EXPORT_STATE_UNSPECIFIED - ONE_TIME_EXPORT_STATE_SCHEDULED - ONE_TIME_EXPORT_STATE_RUNNING - ONE_TIME_EXPORT_STATE_SUCCESS - ONE_TIME_EXPORT_STATE_FAILED - ONE_TIME_EXPORT_STATE_ARCHIVED type: string v1alpha1OneTimeExportStateDetails: description: Additional details about the current state of the export. properties: error: $ref: '#/components/schemas/v1ServiceError' type: object v1ServiceError: properties: badRequest: $ref: '#/components/schemas/v1BadRequest' badResourceState: $ref: '#/components/schemas/v1BadResourceState' code: description: |- Detailed error code, service-specific. E.g. "DnsZoneNotEmpty". Name of the exception, without Exception suffix if not set. Example: for PermissionDeniedException -> code == PermissionDenied. type: string internalError: $ref: '#/components/schemas/v1InternalError' notEnoughResources: $ref: '#/components/schemas/v1NotEnoughResources' operationAborted: $ref: '#/components/schemas/v1OperationAborted' operationConflict: $ref: '#/components/schemas/v1OperationConflict' outOfRange: $ref: '#/components/schemas/v1OutOfRange' permissionDenied: $ref: '#/components/schemas/v1PermissionDenied' quotaFailure: $ref: '#/components/schemas/v1QuotaFailure' resourceAlreadyExists: $ref: '#/components/schemas/v1ResourceAlreadyExists' resourceConflict: $ref: '#/components/schemas/v1ResourceConflict' resourceNotFound: $ref: '#/components/schemas/v1ResourceNotFound' retryType: $ref: '#/components/schemas/ServiceErrorRetryType' service: description: ID of Service which the error originated in. E.g. "dns". type: string tooManyRequests: $ref: '#/components/schemas/v1TooManyRequests' type: object v1BadRequest: description: The request is invalid. properties: violations: description: Describes all violations. items: $ref: '#/components/schemas/v1BadRequestViolation' type: array type: object v1BadResourceState: description: >- The resource we are trying to use, create, change or delete is in a bad state and cannot be used. properties: message: description: The reason why this state is bad and cannot be used. type: string resourceId: description: ID of the resource which is bad. type: string type: object v1InternalError: description: Generic internal error. properties: requestId: description: Error request ID. type: string traceId: description: Trace ID for the failing request. type: string type: object v1NotEnoughResources: description: >- Indicates that there are not enough resources available to perform the requested action. properties: violations: description: Describes all resource violations. items: $ref: '#/components/schemas/v1NotEnoughResourcesViolation' type: array type: object v1OperationAborted: description: Operation on the resource has been aborted by a subsequent operation. properties: abortedByOperationId: description: ID of the subsequent operation. type: string operationId: description: ID of the aborted operation. type: string resourceId: description: Resource ID corresponding to both of the operations. type: string type: object v1OperationConflict: description: >- Operation cannot be started because a conflicting operation is already running on the same resource. Wait until the conflicting operation finishes, then you can retry starting your operation. properties: conflictingOperationId: description: ID of the conflicting operation (the one that's running). type: string resourceId: description: Resource ID corresponding to the conflicting operation. type: string type: object v1OutOfRange: description: >- Indicates that element with requested parameters is exceeding the particular range. properties: limit: description: Available limit. type: string requested: description: Requested value. type: string type: object v1PermissionDenied: description: >- Indicates that the action cannot be performed because there are insufficient access rights to a resource. properties: resourceId: description: ID of the resource that cannot be accessed. type: string type: object v1QuotaFailure: description: >- Indicates a failure due to exceeding specified limits or allocations in a system or service. properties: violations: description: Describes all quota violations. items: $ref: '#/components/schemas/v1QuotaFailureViolation' type: array type: object v1ResourceAlreadyExists: description: Resource we are trying to create already exists. properties: resourceId: description: ID of the existing resource. type: string type: object v1ResourceConflict: description: >- There is a difference between the actual resource state and the expected one. properties: message: description: Detailed info about conflict. type: string resourceId: description: ID of conflicting resource. type: string type: object v1ResourceNotFound: description: Resource we are trying to interact with does not exist. properties: resourceId: description: ID of the requested resource. type: string type: object ServiceErrorRetryType: default: UNSPECIFIED description: |2- - CALL: Just retry the failed call. - UNIT_OF_WORK: Retry whole logic before call and make a new one. - NOTHING: Do not retry, this is a fatal error. enum: - UNSPECIFIED - CALL - UNIT_OF_WORK - NOTHING type: string v1TooManyRequests: description: >- You initiated too many requests to the service at once. Enhance your calm. properties: violation: description: What request limit is exceeded (service-dependent). type: string type: object v1BadRequestViolation: properties: field: description: What field value is invalid. type: string message: description: Description why the value is invalid, in English. type: string type: object v1NotEnoughResourcesViolation: properties: message: description: A description of how the resource is insufficient. type: string requested: description: Requested value. type: string resourceType: title: >- The type of resource that is insufficient. This field is populated when it is possible to determine the lacking resource type. **Not for programmatic use.** type: string type: object v1QuotaFailureViolation: properties: limit: description: Maximum permissible value. type: string message: description: A description of how the quota check failed. type: string quota: description: Which quota check failed. type: string requested: description: Requested value. type: string type: object securitySchemes: bearerAuth: description: The Authorization header expects a Bearer token. scheme: bearer type: http ````