Acuity Lab API Documentation - Procurement Data Repository

Base URL: https://acuitylab.net/api/procurement

Authentication

All requests to the Procurement Data API require an API key. Include the API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Error Responses

200 OK: Request was successful.
400 Bad Request: The request was invalid.
401 Unauthorized: API key is missing or invalid.
403 Forbidden: The API key does not have permissions for the requested resource.
404 Not Found: The requested resource could not be found.
500 Internal Server Error: Something went wrong on the server side.

5.1 GET /procurement/contracts

Retrieve procurement contract data, including details on awarded contracts, values, and timelines.

GET https://acuitylab.net/api/procurement/contracts?country=US§or=healthcare&date_range=2024-01-01to2024-01-31

{
    "country": "US",
    "sector": "healthcare",
    "contracts": [
        {
            "contract_id": "CON12345",
            "title": "Hospital Equipment Supply",
            "contract_value": "$2,000,000",
            "award_date": "2024-01-15",
            "supplier": "Medical Supplies Inc.",
            "timeline": {
                "start": "2024-02-01",
                "end": "2024-08-01"
            }
        },
        {
            "contract_id": "CON98765",
            "title": "COVID-19 Vaccine Distribution",
            "contract_value": "$15,000,000",
            "award_date": "2024-01-20",
            "supplier": "Vaccine Global Co.",
            "timeline": {
                "start": "2024-02-15",
                "end": "2024-06-30"
            }
        }
    ]
}

5.2 GET /procurement/tenders

Retrieve open tenders for upcoming projects or supply needs, with filtering by country, sector, and deadlines.

GET https://acuitylab.net/api/procurement/tenders?country=UK§or=construction&deadline=2024-03-01

{
    "country": "UK",
    "sector": "construction",
    "tenders": [
        {
            "tender_id": "TEND12345",
            "description": "Road Construction in London",
            "value": "£5,000,000",
            "closing_date": "2024-03-01"
        },
        {
            "tender_id": "TEND67890",
            "description": "New Office Building in Manchester",
            "value": "£3,500,000",
            "closing_date": "2024-02-25"
        }
    ]
}

5.3 GET /procurement/bids

Retrieve bid data for ongoing or completed procurement processes, including the bidders and bid amounts.

GET https://acuitylab.net/api/procurement/bids?contract_id=CON12345

{
    "contract_id": "CON12345",
    "bids": [
        {
            "bidder": "Construction Corp",
            "bid_amount": "$4,950,000"
        },
        {
            "bidder": "Builders United",
            "bid_amount": "$5,100,000"
        }
    ]
}

5.4 GET /procurement/suppliers

Retrieve a list of suppliers who are awarded contracts or submit tenders in the procurement system.

GET https://acuitylab.net/api/procurement/suppliers?sector=technology&country=Germany

{
    "sector": "technology",
    "suppliers": [
        {
            "supplier_id": "SUP12345",
            "name": "Tech Innovations GmbH",
            "country": "Germany",
            "total_contracts": 15,
            "total_value": "$10,000,000"
        },
        {
            "supplier_id": "SUP67890",
            "name": "AI Solutions Ltd.",
            "country": "Germany",
            "total_contracts": 8,
            "total_value": "$5,500,000"
        }
    ]
}

5.5 GET /procurement/contract-history

Retrieve the contract history of a specific supplier, including awarded contracts, values, and performance reviews.

GET https://acuitylab.net/api/procurement/contract-history?supplier_id=SUP12345

{
    "supplier_id": "SUP12345",
    "contracts": [
        {
            "contract_id": "CON23456",
            "title": "Smart City Project",
            "contract_value": "$3,000,000",
            "award_date": "2024-01-01",
            "performance": "excellent"
        },
        {
            "contract_id": "CON67890",
            "title": "Cybersecurity Upgrade",
            "contract_value": "$1,500,000",
            "award_date": "2023-09-15",
            "performance": "good"
        }
    ]
}

5.6 GET /procurement/contract-status

Retrieve the status of ongoing contracts, including delivery dates, completion percentages, and milestones.

GET https://acuitylab.net/api/procurement/contract-status?contract_id=CON23456&status=inprogress

{
    "contract_id": "CON23456",
    "status": "in progress",
    "completion_percentage": 75,
    "milestones": [
        {
            "milestone_id": "MILE123",
            "description": "Phase 1 completed",
            "completion_date": "2024-02-01"
        },
        {
            "milestone_id": "MILE456",
            "description": "Phase 2 ongoing",
            "expected_completion_date": "2024-03-15"
        }
    ]
}

5.7 GET /procurement/awardees

Retrieve the list of companies or suppliers awarded contracts within a specified date range.

GET https://acuitylab.net/api/procurement/awardees?date_range=2024-01-01to2024-02-01§or=infrastructure

{
    "date_range": "2024-01-01 to 2024-02-01",
    "awardees": [
        {
            "supplier": "BuildFast Co.",
            "contract_id": "CON12345",
            "contract_value": "$4,000,000",
            "sector": "infrastructure"
        },
        {
            "supplier": "Green Energy Group",
            "contract_id": "CON54321",
            "contract_value": "$6,500,000",
            "sector": "energy"
        }
    ]
}