---
title: "Rows → an agency upload file (text/plain): sss-r3, bir-qap, bir-sawt, bir-1604e. Not metered, nothing stored. Validate it in the agency's own validator before you submit."
method: POST
path: "/api/v1/agency-upload/{kind}"
tags: ["Agency upload"]
---

# Rows → an agency upload file (text/plain): sss-r3, bir-qap, bir-sawt, bir-1604e. Not metered, nothing stored. Validate it in the agency's own validator before you submit.

`POST /api/v1/agency-upload/{kind}`

## Request

- Base URL: `https://philforms.com`
- URL: `https://philforms.com/api/v1/agency-upload/{kind}`
- Auth: HTTP bearer

## Path parameters

- `kind` string, required

## Request body

- object: sss-r3: { employer: { employer_no, employer_name, period }, row: [{ last_name, first_name, middle_name, sss_no, ss: [3], ec: [3], remark, date }] } · bir-qap: { agent: { tin, registered_name, rdo, period }, row: [{ tin, registered_name | last_name/first_name/middle_name, atc, rate, income, tax? }] } · bir-sawt: { payee, row, form } · bir-1604e: { agent: { tin, registered_name, rdo, year }, row }

## Response `200`

The file

## Other responses

- `400`: A row or header problem (`issue` per row for SSS R-3)
- `404`: Unknown kind

---

[API](https://skmtc.dev/philforms/apis/philforms-api.md) · [All operations](https://skmtc.dev/philforms/apis/philforms-api/llms.txt) · [OpenAPI document](https://skmtc.dev/philforms/apis/philforms-api/revisions/a43bf313729c?raw)