---
title: "Retrieve a job of hard deleting billing document files"
method: GET
path: "/v1/accounts/billing-documents/files/deletion-jobs/{jobId}"
tags: ["Billing Documents"]
---

# Retrieve a job of hard deleting billing document files

`GET /v1/accounts/billing-documents/files/deletion-jobs/{jobId}`

## Request

- Base URL: `https://rest.test.zuora.com`
- URL: `https://rest.test.zuora.com/v1/accounts/billing-documents/files/deletion-jobs/{jobId}`
- Auth: HTTP bearer

Retrieves information about an asynchronous job of permanently deleting all billing document PDF files for specific accounts.

**Note**: This operation can be used only if you have the Billing user permission "Hard Delete Billing Document Files" enabled.

## Path parameters

- `jobId` string, required

## Headers

- `Accept-Encoding` string
- `Content-Encoding` string
- `Zuora-Track-Id` string
- `Zuora-Entity-Ids` string
- `Zuora-Org-Ids` string
- `Zuora-Version` string

## Response `200`

OK

- GETBillingDocumentFilesDeletionJobResponse
  - `id` string: The unique ID of the billing document file deletion job.
  - `status` 'Pending' | 'Processing' | 'Completed' | 'Error': The status of the billing document file deletion job.
  - `success` boolean: Returns `true` if the request was processed successfully.

## Other responses

- `500`: Internal Server Error
- `4XX`: Request Errors

---

[API](https://skmtc.dev/zuora/apis/api-reference.md) · [All operations](https://skmtc.dev/zuora/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc.dev/zuora/apis/api-reference/revisions/2deecb0dd041?raw)