songs/getInfo

Find song based on its ID. The fields listed here will be returned when this method is called.

POST
https://api.elvanto.com/v1/songs/getInfo.{json|xml|php}

Parameters

Name Type Description
id Required string The ID of the song.
files boolean Return attached files.
Expected request JSON HTTP POST
{
    "id": "84937df8-e993-11e2-b739-a20c5589acc5",
    "files": true
}
Expected response JSON XML PHP
{
    "generated_in": "0.018",
    "status": "ok",
    "song": [
        {
            "id": "84937df8-e993-11e2-b739-a20c5589acc5",
            "status": 1,
            "date_added": "2024-02-24 11:56:22",
            "date_modified": "2024-08-27 16:17:57",
            "title": "Adonai",
            "permalink": "adonai",
            "number": "12345678",
            "item": 1,
            "learn": 0,
            "allow_downloads": 1,
            "artist": "Mia Fieldes, Raymond Badham",
            "album": "",
            "notes": "",
            "categories": {
                "category": [
                    {
                        "id": "dhe398d8-a251-102c-a245-1559817ce81a",
                        "name": "Praise"
                    }
                ]
            },
            "locations": {
                "location": [
                    {
                        "id": "d7r998d8-a251-102c-a245-1559817ce81a",
                        "name": "South Campus"
                    }
                ]
            }
        }
    ]
}
Error responses

Please see our response status codes documentation for details of potential error responses for any API request.

  • 401: No Song ID provided You need to specify the ID of the song.
  • 404: Invalid Song ID The ID you provided does not exist.