Download OpenAPI specification:Download
The IPaC location API enables external applications to create and request data from IPaC through a RESTful interface. IMPORTANT: THE LOCATION API WILL EVENTUALLY REQUIRE AN API KEY FOR ACCESS. TO BE NOTIFIED OF UPCOMING CHANGES TO THE API, PLEASE SEND AN EMAIL TO fwhq_ipac@fws.gov.
Retrieve species, critical habitat, FWS field office, migratory bird, marine mammal, fish hatcheries, refuges, wetlands, and CBRA information about the specified location.
The location for which to retrieve resources.
projectLocationWKT required | string <Open Geospatial Consortium (OGC) well-known text (WKT)> Open Geospatial Consortium (OGC) well-known text (WKT) representing a location. At this time only the LINESTRING, POLYGON and MULTIPOLYGON geometry types are supported. See the OGC Simple Feature Access specification for a description of well-known text syntax. |
timeout | integer <int32> Default: 2 The timeout (in seconds) for other FWS resource calls. |
apiVersion | string <semantic version number> Forces the version of the API to be the specified version if it is still supported. If the version specified is no longer supported an error will thrown. If no version is specified the latest version will be used. |
locationFormat | string Default: "GeoJSON" The location format for the location.footprint parameter. Either "WKT" or "GeoJSON" |
includeOtherFwsResources | boolean Default: true A flag to indicate whether IPaC should request other FWS resources (e.g. Migratory birds, Fish hatcheries, Wetlands, etc.). |
includeCrithabGeometry | boolean Default: false A flag to indicate whether IPaC should include the critical habitat geometry as part of the response. Note that some critical habitat geometries are very complex and may slow down the response significantly. |
saveLocationForProjectCreation | boolean Default: false A flag to indicate whether this location should be saved for project creation. If true, a URL will be returned for easy project creation. |
{- "location.footprint": "{\"coordinates\":[[[-95.1306152,30.4486737],[-93.6584473,29.4061051],[-94.6691895,28.5314486],[-96.5368652,29.9834867],[-95.1306152,30.4486737]]],\"type\":\"Polygon\"}",
- "timeout": 2,
- "apiVersion": "1.0.0",
- "locationFormat": "GeoJSON",
- "includeOtherFwsResources": true,
- "includeCrithabGeometry": false,
- "saveLocationForProjectCreation": false
}
{- "resources": {
- "apiVersion": "1.0.0",
- "notification": "The API will be down for maintenance on Jan 4, 2097 from 5PM to 7PM EST.",
- "crithabs": [
- {
- "hasGeometry": true,
- "optionalGeometry": {
- "coordinates": [ ],
- "type": "string"
}, - "populationSid": "Population$Sid[123]",
- "speciesInFootprint": true,
- "type": "string"
}
], - "facilitiesQueried": true,
- "fieldOffices": [
- {
- "officeName": "string",
- "sid": "FwsOffice$Sid[123]",
- "formattedMailAddress1": "string",
- "formattedMailAddress2": "string",
- "formattedMailCity": "string",
- "formattedMailState": "string",
- "formattedMailZip": "string",
- "mailAndPhysicalAddressTheSame": true,
- "formattedPhysicalAddress1": "string",
- "formattedPhysicalAddress2": "string",
- "formattedPhysicalCity": "string",
- "formattedPhysicalState": "string",
- "formattedPhysicalZip": "string",
- "formattedPhone": "string",
- "formattedFax": "string",
- "officeEmailAddress": "string"
}
], - "fishHatcheries": {
- "items": [
- {
- "acres": 0.1,
- "bounds": {
- "coordinates": [ ],
- "type": "string"
}, - "name": "string",
- "optionalFieldOfficeSid": {
- "id": 0,
- "val": "string"
}, - "orgCode": 0,
- "rslType": "Fish Technology Center",
- "url": "string"
}
], - "truncated": true
}, - "location": {
- "footprint": {
- "coordinates": [ ],
- "type": "string"
}, - "optionalOriginalGeometry": {
- "coordinates": [ ],
- "type": "string"
}, - "optionalSelectedFips": "string",
- "description": "string",
- "optionalBufferDistance": 0.1,
- "selectionMode": "string"
}, - "marineMammals": [
- {
- "ranges": [
- {
- "optionalCondition": "string",
- "seasons": [ ],
- "fieldOfficeSid": "FwsOffice$Sid[123]"
}
], - "populationSid": "Population$Sid[123]"
}
], - "migbirds": [
- {
- "bcc": true,
- "level": {
- "enumType": "string",
- "name": "BCC_RANGEWIDE_CON"
}, - "optionalBreedsFrom": "2019-08-24T14:15:22Z",
- "optionalBreedsTo": "2019-08-24T14:15:22Z",
- "phenologySpecies": {
- "code": "string",
- "commonName": "string",
- "scientificName": "string",
- "weeklyData": [
- {
- "aggEventCount": 0,
- "aggProbability": 0,
- "phenologyBarHeight": 0,
- "phenologyYPosition": 0,
- "surveyBarHeight": 0,
- "surveyYPosition": 0,
- "weekId": 0
}
]
}, - "populationSid": "Population$Sid[123]"
}
], - "migbirdsQueried": true,
- "numFacilities": 0,
- "allReferencedPopulationsBySid": {
- "property1": {
- "groupCode": "string",
- "groupName": "string",
- "listingStatusCode": "E",
- "listingStatusName": "Endangered",
- "optionalListingStatusDescription": "string",
- "optionalCommonName": "string",
- "optionalScientificName": "string",
- "optionalPopulationDescription": "string",
- "optionalSpeciesDescription": "string",
- "shortName": "string",
- "sid": "Population$Sid[123]",
- "speciesId": 0,
- "speciesProfileUrl": "string"
}, - "property2": {
- "groupCode": "string",
- "groupName": "string",
- "listingStatusCode": "E",
- "listingStatusName": "Endangered",
- "optionalListingStatusDescription": "string",
- "optionalCommonName": "string",
- "optionalScientificName": "string",
- "optionalPopulationDescription": "string",
- "optionalSpeciesDescription": "string",
- "shortName": "string",
- "sid": "Population$Sid[123]",
- "speciesId": 0,
- "speciesProfileUrl": "string"
}
}, - "populationsBySid": {
- "property1": {
- "conditional": true,
- "conditions": [
- null
], - "crithabInFootprint": true,
- "optionalFederalRegisterCrithabStatus": {
- "sid": "Population$Sid[123]",
- "type": "Final",
- "date": "2019-08-24T14:15:22Z",
- "isFileLocal": true,
- "url": "string"
}, - "population": {
- "groupCode": "string",
- "groupName": "string",
- "listingStatusCode": "E",
- "listingStatusName": "Endangered",
- "optionalListingStatusDescription": "string",
- "optionalCommonName": "string",
- "optionalScientificName": "string",
- "optionalPopulationDescription": "string",
- "optionalSpeciesDescription": "string",
- "shortName": "string",
- "sid": "Population$Sid[123]",
- "speciesId": 0,
- "speciesProfileUrl": "string"
}, - "ranges": [
- {
- "optionalCondition": "string",
- "seasons": [ ],
- "fieldOfficeSid": "FwsOffice$Sid[123]"
}
], - "tessDocuments": [
- {
- "docUrl": "string",
- "docTitle": "string",
- "docDate": "2019-08-24T14:15:22Z",
- "docType": "Species Survey Guidelines",
- "description": "string",
- "officeSid": "FwsOffice$Sid[123]"
}
]
}, - "property2": {
- "conditional": true,
- "conditions": [
- null
], - "crithabInFootprint": true,
- "optionalFederalRegisterCrithabStatus": {
- "sid": "Population$Sid[123]",
- "type": "Final",
- "date": "2019-08-24T14:15:22Z",
- "isFileLocal": true,
- "url": "string"
}, - "population": {
- "groupCode": "string",
- "groupName": "string",
- "listingStatusCode": "E",
- "listingStatusName": "Endangered",
- "optionalListingStatusDescription": "string",
- "optionalCommonName": "string",
- "optionalScientificName": "string",
- "optionalPopulationDescription": "string",
- "optionalSpeciesDescription": "string",
- "shortName": "string",
- "sid": "Population$Sid[123]",
- "speciesId": 0,
- "speciesProfileUrl": "string"
}, - "ranges": [
- {
- "optionalCondition": "string",
- "seasons": [ ],
- "fieldOfficeSid": "FwsOffice$Sid[123]"
}
], - "tessDocuments": [
- {
- "docUrl": "string",
- "docTitle": "string",
- "docDate": "2019-08-24T14:15:22Z",
- "docType": "Species Survey Guidelines",
- "description": "string",
- "officeSid": "FwsOffice$Sid[123]"
}
]
}
}, - "refuges": {
- "items": [
- {
- "acres": 0.1,
- "bounds": {
- "coordinates": [ ],
- "type": "string"
}, - "name": "string",
- "optionalFieldOfficeSid": {
- "id": 0,
- "val": "string"
}, - "orgCode": 0,
- "rslType": "Fish Technology Center",
- "url": "string"
}
], - "truncated": true
}, - "wetlands": {
- "items": [
- {
- "acres": 0.1,
- "bounds": {
- "coordinates": [ ],
- "type": "string"
}, - "name": "string",
- "optionalFieldOfficeSid": {
- "id": 0,
- "val": "string"
}, - "orgCode": 0,
- "rslType": "Fish Technology Center",
- "url": "string"
}
], - "truncated": true
}, - "wetlandsQueried": true,
- "coastalBarriers": {
- "items": [
- {
- "acres": 0.1,
- "bounds": {
- "coordinates": [ ],
- "type": "string"
}, - "name": "string",
- "optionalFieldOfficeSid": {
- "id": 0,
- "val": "string"
}, - "orgCode": 0,
- "rslType": "Fish Technology Center",
- "url": "string"
}
], - "truncated": true
}, - "coastalBarriersQueried": true
}, - "startProjectURL": {
- "startProjectURL": "string"
}
}