Report series

Reported payment practices

What the company reported to the government about how it pays its suppliers: the reporting period, the date the report was filed, the average time to pay, the share of invoices paid within 30 days, in 31 to 60 days and later than 60 days, the share not paid within the agreed terms, its standard payment terms, and whether it offers e-invoicing or supply-chain finance, with the report's address on the government's service.

These are the company's own figures, reported by the company to the government under the Reporting on Payment Practices and Performance Regulations 2017, and shown as reported. CompanyStack has not checked them; they are not a credit rating, a score or an assessment, and no threshold is applied to them. Only large companies and limited liability partnerships have to report (each half of their financial year, within 30 days of its end), so a company with no report answers reported: false, which says nothing about how it pays.

Source: the government's Check payment practices service (Department for Business and Trade), https://check-payment-practices.service.gov.uk/. Contains public sector information licensed under the Open Government Licence v3.0. CompanyStack reloads the published data weekly; report_source.checked_at is the last check.

Every plan, API Free included, gets the latest report (level: summary). API Starter and above, and web-app Pro and Team, also get history: every report the company has filed, newest period first (level: full). Reports are never removed from the history: when a company reports again on a period both reports are listed (reports_for_period), and a report the government no longer lists is kept with listed: false. No Companies House request is made.

get/company/{number}/payment-practices

Request

  • Base URL: https://api.companystack.co.uk
  • URL: https://api.companystack.co.uk/company/{number}/payment-practices
  • Auth: one of:
    • HTTP bearer
    • API key in header X-Api-Key

Path parameters

numberstring required

Response

The latest report (and, on level full, the history), or reported: false

company_numberstring required
company_namestring
company_statusstring nullable
reportedboolean required

false: no report from this company is in the government data held

level'summary' | 'full' required
messagestring

reported: false only. Why having no report says nothing about the company

checked_atstring date-time nullable

reported: false only. When the government's data was last checked

title'Reported payment practices'
statementstring

One sentence: who reported what, for which period, filed when

caveatsstring[]
reports_heldinteger

Every report held for the company, the latest included

first_period_startstring date nullable
history_onstring

Level summary only: what the full answer adds

notestring

That these are the company's own figures

noticestring

Changes

No recorded changes to this operation across all 1 revision of this API.