Download an invoice PDF
Step two of downloading an invoice's PDF: answers the file the link names, for the person the link was given to, while it lasts. Your right to read the account's billing is checked again, and each download is recorded in the company's activity.
GET/ api/ corestack/ billing/ pdf/ {token}
Path parameters
tokenstringRequired
The token at the end of download_url, as POST / answered it.
Returns
200 The invoice, as a PDF file named for the invoice number.
Fields of the 200 answer
If it is refused
| Status | Reason | What to do |
|---|---|---|
401 | none | Send a valid token as Authorization: Bearer <token>. |
403 | billing_forbidden | Billing is for the organisation's owner and billing contacts. Ask one of them to do this. |
403 | company_unavailable | Your company is unavailable. |
403 | scope_required | Use a token with the scope named in scope. |
403 | two_factor_required | Turn on two-factor on your account, then send again. |
404 | feature_off | This feature is not on for your organisation yet. |
404 | pdf_missing | The PDF of this invoice could not be found. Open a ticket and we will send it. |
409 | pdf_pending | The invoice's PDF is not ready yet. Try again in a few minutes. |
410 | link_expired | This link has expired. Open the invoice and download again. |
429 | rate_limited | Wait for the seconds in Retry-After. |
Reasons are listed by name in Errors and refusals.
The same task elsewhere
curl https://manage.corefinity.com/api/corestack/billing/pdf/string \
-H "Authorization: Bearer $COREFINITY_TOKEN" \
-H "Accept: application/json"use Illuminate\Support\Facades\Http;
$response = Http::withToken(env('COREFINITY_TOKEN'))
->acceptJson()
->get('https://manage.corefinity.com/api/corestack/billing/pdf/string');
$data = $response->json();const res = await fetch('https://manage.corefinity.com/api/corestack/billing/pdf/string', {
method: 'GET',
headers: {
Authorization: `Bearer ${process.env.COREFINITY_TOKEN}`,
Accept: 'application/json',
},
});
// An answer with no body (204) has nothing to parse.
const text = await res.text();
const data = text && JSON.parse(text);import os
import requests
res = requests.get(
"https://manage.corefinity.com/api/corestack/billing/pdf/string",
headers={
"Authorization": f"Bearer {os.environ['COREFINITY_TOKEN']}",
"Accept": "application/json",
},
)
data = res.json() if res.content else None"string"{
"message": "Unauthenticated."
}{
"code": "billing_forbidden",
"message": "Billing is available to your company's owner and billing contacts.",
"reason": "billing_forbidden"
}{
"code": "feature_off",
"message": "Not found.",
"reason": "feature_off"
}{
"code": "pdf_pending",
"message": "The PDF of this invoice is not ready yet.",
"reason": "pdf_pending"
}{
"code": "link_expired",
"message": "This link has expired. Open the invoice and download again.",
"reason": "link_expired"
}{
"code": "rate_limited",
"message": "Too many requests. Try again in 60 seconds.",
"reason": "rate_limited",
"retry_after_seconds": 60
}Try it
Try it is off for this endpointIt has not been cleared for the console. Copy the request and run it yourself when you are sure.
Was this helpful?