# Get Biller Details
source: https://developer.mastercard.com/rpps-biller-maintenance-service/documentation/use-cases/get-biller-details/index.md

### Get Biller Details {#get-biller-details}

Concentrators can get biller details for purposes of validating the records in RPPS as well as retrieving the keys for updating the records in the edit biller. This is performed via the Remote Payment and Presentment Service (RPPS) Biller Maintenance Service directly from their system. The API will ensure all the business rules are being met, and if not, will advise the Concentrator when issues arise and how to correct them. This is accomplished by calling the /biller/{biller_id} path.

## Getting Biller Details {#getting-biller-details}

### Request - Static Test Data {#request---static-test-data}

Below is an example request body for getting the biller details.

    /biller/{biller_id}

### Response - Success {#response---success}

```json
  {
	"effectiveDate": "2024/12/16",
	"rppsBiller": {
		"billerInfo": {
			"rppsId": "00027877",
			"billerId": "0123456883",
			"billerName": "CALLSOURCE",
			"batchName": "CALLSOURCE",
			"billerClass": "OTH",
			"billerType": "GTW",
			"remittanceRTN": "111111111",
			"remittanceDDA": "654321",
			"preNotes": "N",
			"billerStatus": "Active"
		},
		"addresses": [
			{
				"key": 214128,
				"type": "Sta",
				"address1": "PO BOX 60280",
				"city": "LOS ANGELES",
				"state": "CA",
				"postalCode": "90060-0280"
			}
		],
		"masks": [
			{
				"key": 1942,
				"maskFormat": "!!!!!!!!!!!!!!",
				"maskDescriptions": [
					"Standard Mask"
				]
			},
			{
				"key": 1945,
				"maskFormat": "!!!!!!!!!!!",
				"maskDescriptions": [
					"Standard Mask"
				]
			},
			{
				"key": 1946,
				"maskFormat": "!!!!!!!!!!",
				"maskDescriptions": [
					"Standard Mask"
				]
			},
			{
				"key": 1947,
				"maskFormat": "!!!!!!!!!",
				"maskDescriptions": [
					"Standard Mask"
				]
			},
			{
				"key": 1948,
				"maskFormat": "!!!!!!!!",
				"maskDescriptions": [
					"Standard Mask"
				]
			},
			{
				"key": 1949,
				"maskFormat": "!!!!!!!",
				"maskDescriptions": [
					"Standard Mask"
				]
			},
			{
				"key": 1950,
				"maskFormat": "!!!!!!",
				"maskDescriptions": [
					"Standard Mask"
				]
			},
			{
				"key": 1951,
				"maskFormat": "!!!!!",
				"maskDescriptions": [
					"Standard Mask"
				]
			},
			{
				"key": 1952,
				"maskFormat": "!!!!",
				"maskDescriptions": [
					"Standard Mask"
				]
			},
			{
				"key": 1953,
				"maskFormat": "!!!",
				"maskDescriptions": [
					"Standard Mask"
				]
			},
			{
				"key": 1954,
				"maskFormat": "!!",
				"maskDescriptions": [
					"Standard Mask"
				]
			},
			{
				"key": 1955,
				"maskFormat": "!",
				"maskDescriptions": [
					"Standard Mask"
				]
			}
		]
	}
}
```

### Response - Error {#response---error}

Example error showing what would happen if the client id used did not have access to onboard a biller.

```json
{
  "Errors": {
    "Error": [
      {
        "Source": "RPPS Biller Maintenance Service",
        "ReasonCode": "BPBMSAPI_ERR_0021",
        "Description": "User Error",
        "Recoverable": true,
        "Details": "Biller ID must be 10 digits"
      }
    ]
  }
}
```

## Next Steps {#next-steps}

For what is required in the payload, please refer to [Parameters](https://developer.mastercard.com/rpps-biller-maintenance-service/documentation/parameters/wr-status-parameters/index.md).

Please continue to [API Reference](https://developer.mastercard.com/rpps-biller-maintenance-service/documentation/api-reference/index.md).