# PadMapper Building Fees

Returns the move-in, pet, parking, and other fees for one building. Large buildings can take several seconds.

- **Documentation:** [https://scrappa.co/docs/padmapper-api/padmapper_building_fees](https://scrappa.co/docs/padmapper-api/padmapper_building_fees)
- **API group:** PadMapper API
- **Endpoint:** `GET https://scrappa.co/api/padmapper/building-fees`

## Authentication

Send your Scrappa API key in the `X-API-KEY` request header. Paid endpoints also support accountless x402 payments when called without an API key.

## Parameters

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `building_id` | string | Yes | Building id from search results. |

## Example response

```json
{
    "data": {
        "fees": [
            {
                "name": "Deposit",
                "type": 3,
                "costs": [
                    {
                        "name": "Deposit",
                        "cadence": 0,
                        "is_fixed": false,
                        "cost_type": 1,
                        "lifecycle": 2,
                        "refundable": null,
                        "description": "",
                        "max_in_cents": 0,
                        "min_in_cents": 0,
                        "is_refundable": null
                    }
                ],
                "count": null,
                "source": "building.fees",
                "group_key": "3",
                "is_derived": true,
                "requirement": 1
            },
            {
                "name": "Covered Lot",
                "type": 7,
                "costs": [
                    {
                        "name": "Parking Fee",
                        "cadence": 30,
                        "is_fixed": false,
                        "cost_type": 1,
                        "lifecycle": 3,
                        "refundable": null,
                        "description": "",
                        "max_in_cents": null,
                        "min_in_cents": null,
                        "is_refundable": null
                    }
                ],
                "count": {
                    "max": 2,
                    "default": 0,
                    "max_source": "default"
                },
                "source": "building.parking",
                "group_key": "7-covered_lot",
                "is_derived": false,
                "requirement": 2
            },
            {
                "name": "Unknown",
                "type": 7,
                "costs": [
                    {
                        "name": "Parking Fee",
                        "cadence": 30,
                        "is_fixed": false,
                        "cost_type": 1,
                        "lifecycle": 3,
                        "refundable": null,
                        "description": "",
                        "max_in_cents": null,
                        "min_in_cents": null,
                        "is_refundable": null
                    }
                ],
                "count": {
                    "max": 2,
                    "default": 0,
                    "max_source": "default"
                },
                "source": "building.parking",
                "group_key": "7-unknown",
                "is_derived": false,
                "requirement": 2
            }
        ],
        "phone": "(289) 804-1151",
        "units": [
            {
                "fees": [
                    {
                        "name": "Rent",
                        "type": 4,
                        "costs": [
                            {
                                "name": "Base Rent",
                                "cadence": 30,
                                "is_fixed": true,
                                "cost_type": 1,
                                "lifecycle": 3,
                                "refundable": null,
                                "description": "Monthly rent payment",
                                "max_in_cents": 206200,
                                "min_in_cents": 206200,
                                "is_refundable": null
                            }
                        ],
                        "count": null,
                        "source": "unit.rent",
                        "group_key": "4",
                        "is_derived": false,
                        "requirement": 1
                    },
                    {
                        "name": "Deposit",
                        "type": 3,
                        "costs": [
                            {
                                "name": "Deposit",
                                "cadence": 0,
                                "is_fixed": false,
                                "cost_type": 1,
                                "lifecycle": 2,
                                "refundable": null,
                                "description": "",
                                "max_in_cents": null,
                                "min_in_cents": 0,
                                "is_refundable": null
                            }
                        ],
                        "count": null,
                        "source": "floorplan.fees",
                        "group_key": "3",
                        "is_derived": false,
                        "requirement": 1
                    },
                    {
                        "name": "Unknown",
                        "type": 7,
                        "costs": [
                            {
                                "name": "Parking Fee",
                                "cadence": 30,
                                "is_fixed": false,
                                "cost_type": 1,
                                "lifecycle": 3,
                                "refundable": null,
                                "description": "",
                                "max_in_cents": null,
                                "min_in_cents": null,
                                "is_refundable": null
                            }
                        ],
                        "count": {
                            "max": 2,
                            "default": 0,
                            "max_source": "default"
                        },
                        "source": "building.parking",
                        "group_key": "7-unknown",
                        "is_derived": false,
                        "requirement": 2
                    }
                ],
                "name": "Unit 762-0722",
                "unit_id": 13684077,
                "bedrooms": 0,
                "bathrooms": 1,
                "max_price": 2062,
                "min_price": 2062,
                "listing_id": 65628271,
                "building_id": 2058520,
                "base_max_price": 2062,
                "base_min_price": 2062,
                "half_bathrooms": 0
            },
            {
                "fees": [
                    {
                        "name": "Rent",
                        "type": 4,
                        "costs": [
                            {
                                "name": "Base Rent",
                                "cadence": 30,
                                "is_fixed": true,
                                "cost_type": 1,
                                "lifecycle": 3,
                                "refundable": null,
                                "description": "Monthly rent payment",
                                "max_in_cents": 290000,
                                "min_in_cents": 290000,
                                "is_refundable": null
                            }
                        ],
                        "count": null,
                        "source": "unit.rent",
                        "group_key": "4",
                        "is_derived": false,
                        "requirement": 1
                    },
                    {
                        "name": "Deposit",
                        "type": 3,
                        "costs": [
                            {
                                "name": "Deposit",
                                "cadence": 0,
                                "is_fixed": false,
                                "cost_type": 1,
                                "lifecycle": 2,
                                "refundable": null,
                                "description": "",
                                "max_in_cents": null,
                                "min_in_cents": 0,
                                "is_refundable": null
                            }
                        ],
                        "count": null,
                        "source": "floorplan.fees",
                        "group_key": "3",
                        "is_derived": false,
                        "requirement": 1
                    },
                    {
                        "name": "Unknown",
                        "type": 7,
                        "costs": [
                            {
                                "name": "Parking Fee",
                                "cadence": 30,
                                "is_fixed": false,
                                "cost_type": 1,
                                "lifecycle": 3,
                                "refundable": null,
                                "description": "",
                                "max_in_cents": null,
                                "min_in_cents": null,
                                "is_refundable": null
                            }
                        ],
                        "count": {
                            "max": 2,
                            "default": 0,
                            "max_source": "default"
                        },
                        "source": "building.parking",
                        "group_key": "7-unknown",
                        "is_derived": false,
                        "requirement": 2
                    }
                ],
                "name": "Unit 571-0915",
                "unit_id": 13410115,
                "bedrooms": 2,
                "bathrooms": 1,
                "max_price": 2900,
                "min_price": 2900,
                "listing_id": 65228684,
                "building_id": 2058520,
                "base_max_price": 2900,
                "base_min_price": 2900,
                "half_bathrooms": 0
            },
            {
                "fees": [
                    {
                        "name": "Rent",
                        "type": 4,
                        "costs": [
                            {
                                "name": "Base Rent",
                                "cadence": 30,
                                "is_fixed": true,
                                "cost_type": 1,
                                "lifecycle": 3,
                                "refundable": null,
                                "description": "Monthly rent payment",
                                "max_in_cents": 295000,
                                "min_in_cents": 295000,
                                "is_refundable": null
                            }
                        ],
                        "count": null,
                        "source": "unit.rent",
                        "group_key": "4",
                        "is_derived": false,
                        "requirement": 1
                    },
                    {
                        "name": "Deposit",
                        "type": 3,
                        "costs": [
                            {
                                "name": "Deposit",
                                "cadence": 0,
                                "is_fixed": false,
                                "cost_type": 1,
                                "lifecycle": 2,
                                "refundable": null,
                                "description": "",
                                "max_in_cents": null,
                                "min_in_cents": 0,
                                "is_refundable": null
                            }
                        ],
                        "count": null,
                        "source": "floorplan.fees",
                        "group_key": "3",
                        "is_derived": false,
                        "requirement": 1
                    },
                    {
                        "name": "Unknown",
                        "type": 7,
                        "costs": [
                            {
                                "name": "Parking Fee",
                                "cadence": 30,
                                "is_fixed": false,
                                "cost_type": 1,
                                "lifecycle": 3,
                                "refundable": null,
                                "description": "",
                                "max_in_cents": null,
                                "min_in_cents": null,
                                "is_refundable": null
                            }
                        ],
                        "count": {
                            "max": 2,
                            "default": 0,
                            "max_source": "default"
                        },
                        "source": "building.parking",
                        "group_key": "7-unknown",
                        "is_derived": false,
                        "requirement": 2
                    }
                ],
                "name": "Unit 748-1202",
                "unit_id": 13405776,
                "bedrooms": 2,
                "bathrooms": 1,
                "max_price": 2950,
                "min_price": 2950,
                "listing_id": 65223992,
                "building_id": 2058520,
                "base_max_price": 2950,
                "base_min_price": 2950,
                "half_bathrooms": 0
            }
        ],
        "address": "748 Bathurst St",
        "features": [
            72,
            22,
            93
        ],
        "group_id": -2058520,
        "specials": [
            "Up to One Month Free Rent"
        ],
        "max_price": 4285,
        "min_price": 2062,
        "property_name": "Mirvish Village",
        "base_max_price": 4285,
        "base_min_price": 2062,
        "pricing_disclaimers": null
    },
    "meta": {
        "duration_ms": 640,
        "upstream_calls": 1,
        "endpoint_family": "building-fees"
    },
    "success": true
}
```

## Errors

| Status | Error | Description |
| --- | --- | --- |
| 404 | Not Found | The requested listing, building, agent, or city was not found. Rent reports exist for US cities only. This response is not billable. |
| 422 | Validation Error | A required public parameter is missing or invalid. This response is not billable. |
| 503 | Service Unavailable | The service could not obtain a complete result. This response is not billable. |

## More Scrappa resources

- [API documentation](https://scrappa.co/docs)
- [Full LLM-readable API reference](https://scrappa.co/llms-full.txt)
- [OpenAPI specification](https://scrappa.co/docs/api.json)
- [Pricing](https://scrappa.co/pricing)
