HUD Housing Counselor API Query Tool
Allows searching by name, city, state, and current location to find information regarding Housing Counseling Agencies.
Search by Agency Name, City, and State
Search by Location
Code Samples
function loadJson() {
$.getJSON('http://data.hud.gov/Housing_Counselor/search?AgencyName=&City=&State=', function(result){
$.each(result, function(i, field){
// Access each field by using below code.
// this['agcid']
});
});
}
Response Codes
One of the following response codes will be returned with every request:
| Code | Description |
|---|---|
| 200 | Successful request. |
| 202 | Request processing. You can retry your request, and when it's complete, you'll get a 200 instead. |
| 400 | Bad request. |
| 401 | Unauthorized. You're not authorized to access this resource. |
| 404 | Not found. The resource requested doesn't exist. |
| 429 | Too Many Requests. The client has made too many requests and is currently being rate limited. |
| 500 | Server errors. |
"Search" Web Service Fields
The following fields are available on the Housing Counselor web service.
| AgencyName | City | State |
|---|---|---|
Human Name: Agency Name |
Human Name: City |
Human Name: State |
Type: Text |
Type: Text |
Type: Text |
"Search By Location" Web Service Fields
The following fields are available on the Housing Counselor web service.
| Lat | Long | Distance |
|---|---|---|
Human Name: Latitude |
Human Name: Longitude |
Human Name: Distance (in miles) |
Type: Text |
Type: Text |
Type: Text |
Feedback and Questions
To give feedback or ask questions about this API, please contact HUD at Housing.counseling@hud.gov