Elvanto

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

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

Parameters

Name	Type	Description
id Required	string	The ID of the arrangement.
chord_chart_key	string	If the song has lyrics and chords recorded, this is the key it will transpose the chord chart into.
files	boolean	Return attached files.

Expected request JSON HTTP POST

{
    "id": "48377df8-e993-11e2-b739-a20c5589acc5",
    "chord_chart_key": "F#",
    "files": true
}

id=48377df8-e993-11e2-b739-a20c5589acc5&chord_chart_key=F#&files=1

Expected response JSON XML PHP

{
    "generated_in": "0.021",
    "status": "ok",
    "arrangement": [
        {
            "id": "48377df8-e993-11e2-b739-a20c5589acc5",
            "date_added": "2024-02-24 11:56:22",
            "date_modified": "2024-08-27 16:17:57",
            "name": "Default Arrangement",
            "copyright": "2012 Hillsong Music Publishing",
            "sequence": [
                "Verse 1",
                "Verse 2",
                "Chorus 1",
                "Verse 3",
                "Misc 1"
            ],
            "minutes": "5",
            "seconds": "0",
            "bpm": "74",
            "key_male": "",
            "key_female": "",
            "lyrics": "Verse 1\nI have this hope\nAs an anchor for my soul\nThrough every storm\nI will hold to You\n\nVerse 2\nWith endless love\nAll my fear is swept away\nIn everything\nI will trust in You\n\nChorus\nThere is hope in the promise of the cross\nYou gave everything to save the world You love\nAnd this hope is an anchor for my soul\nOur God will stand unshakable",
            "chord_chart_key": "A#",
            "chord_chart": "Verse 1\nI have this [Gm]hope\nAs an anchor for [A#]my soul\nThrough every[F] storm\nI will hold [D#]to You\n\nVerse 2\nWith endless [Gm]love\nAll my fear is swept a[A#]way\nIn every[F]thing\nI will trust [Gm]in You\n\nChorus\nThere is [D#]hope in the promise of [A#]the cross\nYou gave every[Cm7]thing to [Gm7]save the world [F]You love\nAnd this [D#]hope is an anchor for [Gm]my soul\nOur God [F]will stand unshak[D#]able [Gm] [A#]"
        }
    ]
}

<?xml version="1.0" encoding="UTF-8"?>
<rsp generated_in="0.021" status="ok">
  <arrangement id="84937df8-e993-11e2-b739-a20c5589acc5" minutes="5" seconds="0" bpm="74" key_male="" key_female="">
    <date_added>2024-02-24 11:56:22</date_added>
    <date_modified>2024-08-27 16:17:57</date_modified>
    <name>Default Arrangement</name>
    <copyright>2012 Hillsong Music Publishing</copyright>
    <sequence>Verse 1</sequence>
    <sequence>Verse 2</sequence>
    <sequence>Chorus 1</sequence>
    <sequence>Verse 3</sequence>
    <sequence>Misc 1</sequence>
    <lyrics>Verse 1
I have this hope
As an anchor for my soul
Through every storm
I will hold to You

Verse 2
With endless love
All my fear is swept away
In everything
I will trust in You

Chorus
There is hope in the promise of the cross
You gave everything to save the world You love
And this hope is an anchor for my soul
Our God will stand unshakable</lyrics>
    <chord_chart_key>A#</chord_chart_key>
    <chord_chart>Verse 1
I have this [Gm]hope
As an anchor for [A#]my soul
Through every[F] storm
I will hold [D#]to You

Verse 2
With endless [Gm]love
All my fear is swept a[A#]way
In every[F]thing
I will trust [Gm]in You

Chorus
There is [D#]hope in the promise of [A#]the cross
You gave every[Cm7]thing to [Gm7]save the world [F]You love
And this [D#]hope is an anchor for [Gm]my soul
Our God [F]will stand unshak[D#]able</chord_chart>
  </arrangement>
</rsp>

stdClass Object
(
    [generated_in] => 0.021
    [status] => ok
    [arrangement] => stdClass Object
        (
            [0] => stdClass Object
                (
                    [id] => 48377df8-e993-11e2-b739-a20c5589acc5
                    [date_added] => 2024-02-24 11:56:22
                    [date_modified] => 2024-08-27 16:17:57
                    [name] => Default Arrangement
                    [copyright] => 2012 Hillsong Music Publishing
                    [sequence] => stdClass Object
                        (
                            [0] => Verse 1
                            [1] => Verse 2
                            [2] => Chorus 1
                            [3] => Verse 3
                            [4] => Misc 1
                        )

                    [minutes] => 5
                    [seconds] => 0
                    [bpm] => 74
                    [key_male] => 
                    [key_female] => 
                    [lyrics] => Verse 1
I have this hope
As an anchor for my soul
Through every storm
I will hold to You

Verse 2
With endless love
All my fear is swept away
In everything
I will trust in You

Chorus
There is hope in the promise of the cross
You gave everything to save the world You love
And this hope is an anchor for my soul
Our God will stand unshakable
                    [chord_chart_key] => A#
                    [chord_chart] => Verse 1
I have this [Gm]hope
As an anchor for [A#]my soul
Through every[F] storm
I will hold [D#]to You

Verse 2
With endless [Gm]love
All my fear is swept a[A#]way
In every[F]thing
I will trust [Gm]in You

Chorus
There is [D#]hope in the promise of [A#]the cross
You gave every[Cm7]thing to [Gm7]save the world [F]You love
And this [D#]hope is an anchor for [Gm]my soul
Our God [F]will stand unshak[D#]able [Gm] [A#]
                )

        )

)

Error responses

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

250: Invalid page number The page number you have provided is invalid.
250: Invalid page size The page size must be between 10 and 1000.
401: No Arrangement ID provided You need to specify the ID of the arrangement.
404: Invalid Arrangement ID The ID you provided does not exist.
401: Invalid chord_chart_key parameter You entered an invalid chord chart.