{"info":{"description":"Read-only, source-backed APVMA product and label data. The approved APVMA label remains the legal authority.","title":"APVMA Data Catalogue API","version":"v1"},"openapi":"3.1.0","paths":{"/api/v1/actives/{slug}":{"get":{"description":"Lists products containing the active-constituent slug.","operationId":"browseActive","parameters":[{"description":"Active-constituent slug","in":"path","name":"slug","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful JSON response with source and currency context where applicable."},"404":{"description":"No matching resource."}},"summary":"Browse active products"}},"/api/v1/crops/{slug}":{"get":{"description":"Lists products with a label use matching the crop slug.","operationId":"browseCrop","parameters":[{"description":"Crop slug","in":"path","name":"slug","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful JSON response with source and currency context where applicable."},"404":{"description":"No matching resource."}},"summary":"Browse crop products"}},"/api/v1/dataset-metadata":{"get":{"description":"Returns the DCAT-style dataset metadata, licences, provenance and public distributions.","operationId":"getDatasetMetadata","parameters":null,"responses":{"200":{"description":"Successful JSON response with source and currency context where applicable."},"404":{"description":"No matching resource."}},"summary":"Get FAIR dataset metadata"}},"/api/v1/dataset-status":{"get":{"description":"Returns source, retrieval time, disclaimer, and CC BY attribution.","operationId":"getDatasetStatus","parameters":null,"responses":{"200":{"description":"Successful JSON response with source and currency context where applicable."},"404":{"description":"No matching resource."}},"summary":"Get dataset freshness"}},"/api/v1/openapi.json":{"get":{"description":"Machine-readable API contract.","operationId":"getOpenAPI","parameters":null,"responses":{"200":{"description":"Successful JSON response with source and currency context where applicable."},"404":{"description":"No matching resource."}},"summary":"Get this OpenAPI document"}},"/api/v1/permits/{number}":{"get":{"description":"Returns a permit's status, source URL, retrieval time, disclaimer, and attribution.","operationId":"getPermit","parameters":[{"description":"Permit number","in":"path","name":"number","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful JSON response with source and currency context where applicable."},"404":{"description":"No matching resource."}},"summary":"Get a permit"}},"/api/v1/pests/{slug}":{"get":{"description":"Lists products with a label use matching the pest slug.","operationId":"browsePest","parameters":[{"description":"Pest slug","in":"path","name":"slug","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful JSON response with source and currency context where applicable."},"404":{"description":"No matching resource."}},"summary":"Browse pest products"}},"/api/v1/products/{number}":{"get":{"description":"Returns the product and source, label, extraction, and currency provenance.","operationId":"getProduct","parameters":[{"description":"APVMA product number","in":"path","name":"number","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful JSON response with source and currency context where applicable."},"404":{"description":"No matching resource."}},"summary":"Get a product"}},"/api/v1/products/{number}/{slug}/history":{"get":{"description":"Returns retained registry versions with product provenance.","operationId":"getProductHistory","parameters":[{"description":"APVMA product number","in":"path","name":"number","required":true,"schema":{"type":"string"}},{"description":"Product slug","in":"path","name":"slug","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful JSON response with source and currency context where applicable."},"404":{"description":"No matching resource."}},"summary":"Get product history"}},"/api/v1/products/{number}/{slug}/label/{approval}":{"get":{"description":"Returns page-marked, accessible label text and provenance.","operationId":"getLabel","parameters":[{"description":"APVMA product number","in":"path","name":"number","required":true,"schema":{"type":"string"}},{"description":"Product slug","in":"path","name":"slug","required":true,"schema":{"type":"string"}},{"description":"Label approval number","in":"path","name":"approval","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful JSON response with source and currency context where applicable."},"404":{"description":"No matching resource."}},"summary":"Get accessible label pages"}},"/api/v1/products/{number}/{slug}/uses/{crop}/{pest}":{"get":{"description":"Returns the rate, verbatim label quote, source page, and provenance.","operationId":"getUse","parameters":[{"description":"APVMA product number","in":"path","name":"number","required":true,"schema":{"type":"string"}},{"description":"Product slug","in":"path","name":"slug","required":true,"schema":{"type":"string"}},{"description":"Crop slug","in":"path","name":"crop","required":true,"schema":{"type":"string"}},{"description":"Pest slug","in":"path","name":"pest","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful JSON response with source and currency context where applicable."},"404":{"description":"No matching resource."}},"summary":"Get a source-backed product use"}},"/api/v1/registrants/{slug}":{"get":{"description":"Lists products matching the registrant slug.","operationId":"browseRegistrant","parameters":[{"description":"Registrant slug","in":"path","name":"slug","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Successful JSON response with source and currency context where applicable."},"404":{"description":"No matching resource."}},"summary":"Browse registrant products"}},"/api/v1/search":{"get":{"description":"Full-text, semantic, or hybrid search with stable faceted filters.","operationId":"searchProducts","parameters":[{"description":"Search text: product, active, crop, pest, or label wording.","in":"query","name":"q","schema":{"type":"string"}},{"description":"Search mode: text, semantic, or hybrid.","in":"query","name":"mode","schema":{"type":"string"}},{"description":"Product category filter.","in":"query","name":"category","schema":{"type":"string"}},{"description":"Active-constituent slug filter.","in":"query","name":"active","schema":{"type":"string"}},{"description":"Crop slug filter.","in":"query","name":"crop","schema":{"type":"string"}},{"description":"Pest slug filter.","in":"query","name":"pest","schema":{"type":"string"}},{"description":"State restriction filter.","in":"query","name":"state","schema":{"type":"string"}},{"description":"Formulation filter.","in":"query","name":"formulation","schema":{"type":"string"}},{"description":"Registrant filter.","in":"query","name":"registrant","schema":{"type":"string"}},{"description":"Poison-schedule filter.","in":"query","name":"poison_schedule","schema":{"type":"string"}},{"description":"Registration-status filter.","in":"query","name":"status","schema":{"type":"string"}}],"responses":{"200":{"description":"Successful JSON response with source and currency context where applicable."},"404":{"description":"No matching resource."}},"summary":"Search products"}}}}
