USA Web Random Child

The USA Web Random Child API is a RESTful API.

The service returns a random child that is currently available on the website.

This is a simple service to return a single, available child. If more control is needed to define criteria about the child, please use the Child Search service.

Sample Requests[string][string][string]

Request Parameters

NameDescriptionRequiredData TypeConstraints
api_key Querystring Parameter. Mashery-supplied key for accessing Compassion International services Yes String  

Specifying Format

By default, all requests will be returned as JSON. There are two ways to indicate an explicit format – either by using an extension on the endpoint (.json or .xml) or by setting the Accept header in the initial request (“application/json” or “application/xml”).

Sample Responses

JSON (/children/random.json)

    "childKey": "ME9630260",
    "childName": "John Doe",
    "childPersonalName": "John",
    "countryName": "Mexico",
    "gender": "M",
    "age": 2,
    "birthDate": "2011-07-11T00:00:00",
    "waitingSinceDate": "2012-10-31T00:00:00",
    "orphan": false,
    "specialNeeds": false,
    "hivAffectedArea": false

XML (/children/random.xml)

    <ChildName>Jane Smith</ChildName>

Docs Navigation