LostAndFound.com Developer's API
Introducing the LostAndFound.com Developer's API.

LostAndFound.com is excited to share the API code with developers for their mobile apps.

We encourage you to add our functionality where possible to your existing mobile app(s). Just make sure your organization has created a VENUE PAGE (if applicable).

  1. Request

    Get API key from cs@lostandfound.com.

  2. Authenticate

    Sign your API requests with your API key.

  3. Start making requests!

    Make requests to our API Endpoints.

LostAndFound.com API Endpoints
get_categories
Fetch the list of categories
get_sub_categories
Fetch the list of sub-categories [needs the parent category info]
get_brands_breeds
Fetch the list of brands/breeds [needs the category info]
getCityStateCountryByZipcode
Fetch the city/state list [needs the zipcode]
get_states
Fetch the list of states [needs the country info]
get_cities
Fetch the list of cities in a state [needs the state and country info]
get_zipcodes
Fetch the list of zipcodes in a city [needs the city, state and country info]
get_accountdetails
Fetch the account details [needs the username and password]
get_accountalerts
Fetch the list of alerts issued to the account [needs the account username and password]
get_accountlistings
Fetch the list of listings linked to a user account [needs the account username and password; and the type of listings (lost/found)]
get_accountvenues
Fetch the venue linked to the user account [needs the account username and password]
get_accountvenues_listings
Fetch the list of listings linked to the venue [needs the venue id]
home_toplistings
Fetch the list of top listings to be shown on the home screen [needs the zipcode]
home_locallistings
Fetch the list of local listings to be shown on the home screen [needs the zipcode]
get_listing_details
Fetch the listing details [needs the listing id]
get_location_details
Fetch the venue details [needs the venue id]
newuser
Create a new user [needs the email, password and phone number]
Example:

URL: http://lostandfound.com/api/newuser

POST Data:

key: f54412f042bae89639707fe31d6efb4baa
u: johndoe@gmail.com
p: {password}
contactEmailAddress: {email}
password: {password}
contactPhoneNumber: {phone}

search_listings
Search and fetch the results [needs the search parameters]
search_venues
Search and fetch the venue results [needs the search parameters]
delete_listing
Delete a listing [needs the listing id]
report_found_item
Report a new found item [needs the account username/password and the listing parameters]
Example:

URL: http://lostandfound.com/api/report_found_item

POST Data:

key: f54412f042bae89639707fe31d6efb4baa
u: johndoe@gmail.com
p: {password}
hn_lost_item: hn_lost_item
hn_country: United States
lostDateMonth: 9
lostDateDay: 24
lostDateYear: 2014
title: Test Listing
category: 29
description: Test Listing
brand: Afghan Hound
primary_color: Black
gender: Male
locationDescription: 123, Park St.
listingDescription: Near the park.
state: Texas
city: Austin
zipcode: 78701
locationType: 25

report_lost_item
Report a new lost item [needs the account username/password and the listing parameters]
Example:

URL: http://lostandfound.com/api/report_lost_item

POST Data:

key: f54412f042bae89639707fe31d6efb4baa
u: johndoe@gmail.com
p: {password}
hn_lost_item: hn_lost_item
hn_country: United States
lostDateMonth: 9
lostDateDay: 24
lostDateYear: 2014
title: Test Listing
category: 29
description: Test Listing
brand: Afghan Hound
primary_color: Black
gender: Male
locationDescription: 123, Park St.
listingDescription: Near the park.
state: Texas
city: Austin
zipcode: 78701
locationType: 25

edit_listing
Edit the listing details [needs the account username/password and the listing parameters]
Example:

URL: http://lostandfound.com/api/edit_listing

POST Data:

key: f54412f042bae89639707fe31d6efb4baa
u: johndoe@gmail.com
p: {password}
lostDateMonth: 9
lostDateDay: 24
lostDateYear: 2014
title: Test Listing
description: Test Listing
locationDescription: 123, Park St.
locationType: 25
city: Austin
state: Texas
zipcode: 78701

report_search_locations
Search venues to be shown in the report lost page
By using the LostAndFound.com Developer's API, you agree to the API Agreement.
Venue Account Access
ID:
Password:
Code:
Poster ID
The Internet Lost and Found provides users with the ability to locally distribute their online ad using posters. These posters contain an Ad ID number which corresponds to the online ad.
ID:
Social Links
Share Your Story
Have a recovery
story of an item
you lost or found?
Send us your experience.
Statistics
United States
Lost Items: 173661
Found Items: 55897
Worldwide
Lost Items: 204351
Found Items: 61933