---
title: "Budget & Cost API"
url: "https://oapi-poc.hdbank.work/apis/budget-cost-api/versions/a9209031-df69-42f7-b7b7-c8be0fdb7639"
---

# Budget & Cost API

OpenAPI specification document.

```json
{"openapi":"3.0.3","info":{"title":"Budget & Cost API","version":"2.1","description":"Ngân sách phân bổ, chi phí thực tế và chỉ số CPI/SPI theo dự án.\n\nAPI mẫu của cổng thử nghiệm, dữ liệu 100% giả lập. Đơn vị: Sovico TMO (TMO · Tài chính). Nhóm: Dự án. Trạng thái: GA. Xác thực dự kiến: mTLS; trên sandbox dùng khóa API."},"servers":[{"url":"https://apis-dev.hdbank.work","description":"Sandbox (dữ liệu giả lập)"}],"security":[{"apiKey":[]}],"components":{"securitySchemes":{"apiKey":{"type":"apiKey","in":"header","name":"apikey","description":"Khóa API sandbox cấp khi tạo ứng dụng trên cổng"}},"schemas":{"Problem":{"type":"object","properties":{"type":{"type":"string"},"title":{"type":"string"},"status":{"type":"integer"},"detail":{"type":"string"}}},"Record":{"type":"object","properties":{"id":{"type":"string"},"api":{"type":"string"},"version":{"type":"string"},"status":{"type":"string"},"note":{"type":"string"}}}}},"paths":{"/budget-cost-api/v2/records":{"get":{"operationId":"list_budget_cost_api","summary":"Danh sách bản ghi mẫu","parameters":[{"name":"X-Correlation-ID","in":"header","schema":{"type":"string","format":"uuid"},"description":"Tự sinh nếu thiếu"},{"name":"X-Mock-Scenario","in":"header","schema":{"type":"string","enum":["400","403","409","429","503"]},"description":"Chỉ sandbox: ép mã lỗi để thử"}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":[{"id":"sample-001","api":"budget-cost-api","version":"v2","status":"SAMPLE","note":"Du lieu mau gia lap"}],"total":1}}}},"400":{"description":"Lỗi","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"403":{"description":"Lỗi","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Lỗi","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"503":{"description":"Lỗi","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}},"/budget-cost-api/v2/records/{id}":{"get":{"operationId":"get_budget_cost_api","summary":"Chi tiết một bản ghi mẫu","parameters":[{"name":"X-Correlation-ID","in":"header","schema":{"type":"string","format":"uuid"},"description":"Tự sinh nếu thiếu"},{"name":"X-Mock-Scenario","in":"header","schema":{"type":"string","enum":["400","403","409","429","503"]},"description":"Chỉ sandbox: ép mã lỗi để thử"},{"name":"id","in":"path","required":true,"schema":{"type":"string"},"example":"sample-001"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Record"},"example":{"id":"sample-001","api":"budget-cost-api","version":"v2","status":"SAMPLE","note":"Du lieu mau gia lap"}}}},"404":{"description":"Lỗi","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}},"429":{"description":"Lỗi","content":{"application/problem+json":{"schema":{"$ref":"#/components/schemas/Problem"}}}}}}}}}
```