> For the complete documentation index, see [llms.txt](https://docs.api.ecoinvent.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.api.ecoinvent.org/api-reference/reporting.md).

# Reporting

## Report API usage

> Validates the submitted dataset and indicator IDs and registers confirmed API usage. Returns 201 Created when at least one valid ID is registered, or 200 OK when none of the submitted IDs are valid and nothing is registered.

```json
{"openapi":"3.1.0","info":{"title":"ecoQuery User API","version":"0.0.1"},"servers":[{"url":"https://api.ecoinvent.org"}],"security":[{"OAuth2ClientCredentials":[]}],"components":{"securitySchemes":{"OAuth2ClientCredentials":{"type":"oauth2","flows":{"clientCredentials":{"scopes":{},"tokenUrl":"https://sso.ecoinvent.org/realms/ecoinvent/protocol/openid-connect/token"}}}},"schemas":{"ReportRequest":{"properties":{"organization_id":{"type":"string","minLength":1,"title":"Organization Id","description":"The organization the data was served to"},"dataset_ids":{"items":{"type":"integer","maximum":2147483647,"exclusiveMinimum":0},"type":"array","maxItems":10000,"title":"Dataset Ids","description":"IDs of datasets consumed"},"indicator_ids":{"items":{"type":"integer","maximum":32767,"exclusiveMinimum":0},"type":"array","maxItems":100,"title":"Indicator Ids","description":"IDs of indicators consumed"}},"type":"object","required":["organization_id","dataset_ids","indicator_ids"],"title":"ReportRequest"},"ReportResponse":{"properties":{"dataset_ids":{"items":{"type":"integer"},"type":"array","title":"Dataset Ids","description":"Registered dataset IDs"},"indicator_ids":{"items":{"type":"integer"},"type":"array","title":"Indicator Ids","description":"Registered indicator IDs"}},"type":"object","required":["dataset_ids","indicator_ids"],"title":"ReportResponse"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"paths":{"/v3/api1/reports":{"post":{"tags":["api"],"summary":"Report API usage","description":"Validates the submitted dataset and indicator IDs and registers confirmed API usage. Returns 201 Created when at least one valid ID is registered, or 200 OK when none of the submitted IDs are valid and nothing is registered.","operationId":"create_report_v3_api1_reports_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReportRequest"}}},"required":true},"responses":{"200":{"description":"No valid IDs to register","content":{"application/json":{}}},"201":{"description":"Successfully registered usage","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReportResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{}}},"403":{"description":"Forbidden","content":{"application/json":{}}},"404":{"description":"Requested resource not found","content":{"application/json":{}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"500":{"description":"Internal Server Error","content":{"application/json":{}}}}}}}}
```