How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Open Food Facts Proofs API

The proofs API from Open Food Facts — 9 operation(s) for proofs.

Open Food Facts Proofs API is one of 46 APIs that Open Food Facts publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Proofs. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and a changelog.

This API exposes 13 operations across 9 paths, and defines 22 schemas. It is described by OpenAPI 3.2.0, at version 0.0.0 (api).

Requests are made against the base URL https://world.openfoodfacts.net.

13 operations 9 paths 22 schemas 2 DELETE5 GET2 PATCH4 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
0.0.0 (api)
Base URL
https://world.openfoodfacts.net
Authentication
HTTP Bearer
License
Resource Areas
1

Authentication & Security 1

Open Food Facts Proofs API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (CustomAuthentication).

Paths & Operations 13

Across 9 paths, the API surfaces 13 operations — 2 DELETE, 5 GET, 2 PATCH, 4 POST. Each is listed below with its method, path, parameters, and response codes.

proofs 13
GET
/api/v1/proofs
Proofs list
proofs_list 32 params → 200
GET
/api/v1/proofs/{id}
Proofs retrieve
proofs_retrieve 1 param → 200
PATCH
/api/v1/proofs/{id}
Proofs partial update
proofs_partial_update 1 param body → 200
DELETE
/api/v1/proofs/{id}
Proofs destroy
proofs_destroy 1 param → 204
GET
/api/v1/proofs/{id}/history
Proofs history list
proofs_history_list 33 params → 200
GET
/api/v1/proofs/drafts
Proofs drafts list
proofs_drafts_list 32 params → 200
GET
/api/v1/proofs/drafts/{id}
Proofs drafts retrieve
proofs_drafts_retrieve 1 param → 200
PATCH
/api/v1/proofs/drafts/{id}
Proofs drafts partial update
proofs_drafts_partial_update 1 param body → 200
DELETE
/api/v1/proofs/drafts/{id}
Proofs drafts destroy
proofs_drafts_destroy 1 param → 204
POST
/api/v1/proofs/drafts/{id}/anonymize
Proofs drafts anonymize create
proofs_drafts_anonymize_create 1 param body → 200
POST
/api/v1/proofs/drafts/upload
Proofs drafts upload create
proofs_drafts_upload_create body → 200
POST
/api/v1/proofs/process-with-gemini
Proofs process with gemini create
proofs_process_with_gemini_create body → 200
POST
/api/v1/proofs/upload
Proofs upload create
proofs_upload_create body → 200

Schemas 22

The contract defines 22 schemas that model the data the API accepts and returns. The most detailed are ProofFull (27 properties), ProofHalfFull (26 properties), Location (26 properties), ProofUpload (13 properties). Each schema is shown below with its type and property counts.

ProofDraftUpload
object
Serializer for draft proof upload - accepts only the file and type fields.
2 properties 2 required
PaginatedProofFullList
object
5 properties 5 required
LocationTypeEnum
string
OSM - OSM ONLINE - ONLINE
NullEnum
ProofPredictionTypeEnum
string
OBJECTDETECTION - OBJECTDETECTION CLASSIFICATION - CLASSIFICATION RECEIPTEXTRACTION - RECEIPTEXTRACTION RECEIPTANONYMIZATION - RECEIPTANONYMIZATION
BlankEnum
CurrencyEnum
string
ADP - ADP AED - AED AFA - AFA AFN - AFN ALK - ALK ALL - ALL AMD - AMD ANG - ANG AOA - AOA AOK - AOK AON - AON AOR - AOR ARA - ARA ARL - ARL ARM - ARM ARP - ARP…
ProofFull
object
27 properties 6 required
ProofTypeEnum
string
PRICETAG - PRICETAG RECEIPT - RECEIPT GDPRREQUEST - GDPRREQUEST SHOPIMPORT - SHOPIMPORT
LocationOsmTypeEnum
string
NODE - NODE WAY - WAY RELATION - RELATION
PatchedProofUpdate
object
11 properties
ProofPrediction
object
7 properties 3 required
ProofHalfFull
object
26 properties 5 required
PaginatedProofHalfFullList
object
5 properties 5 required
ProofUpload
object
13 properties 2 required
ProofUpdate
object
11 properties 1 required
HistoryTypeEnum
string
+ - Created ~ - Changed - - Deleted
ProofHistory
object
6 properties 6 required
ProofProcessWithGemini
object
2 properties 2 required
Location
object
26 properties 4 required
DraftProofAnonymizeRequest
object
Serializer for payload when anonymizing a receipt.
1 property 1 required
PaginatedProofHistoryList
object
5 properties 5 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

open-food-facts-proofs-api-openapi.yml Raw ↑

Other APIs Open Food Facts publishes across the network.

Open Food Facts Cgi API
Open Food Facts Product API
Open Food Facts Search API
Open Food Facts Taxonomy API
Open Food Facts Taxonomy Suggestions API
Open Food Facts Admin - Property Management API
Open Food Facts Admin - Value Management API
Open Food Facts Auth API
Open Food Facts Authentication API
Open Food Facts Autocomplete API
Open Food Facts Badges API
Open Food Facts Challenges API
Where this information came from

This is an independent, third-party profile of Open Food Facts Proofs API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.