Questions? Feedback? powered by Olark live chat software

Escrow Offer API :: Create Offer

Making an offer on an auction

Escrow Offer API has 2 endpoints for making offers on an auction: using the token or the auction id.

Note

Offers will automatically expire in 14 days if they are not accepted.

Making offer using token

Use this endpoint to make an offer as the authenticated user.

1
2
3
4
5
6
7
8
9
curl "https://api.escrow.com/integration/2018-08-01/auction/2d2afb9f-364f-4f9f-82a5-803344d60432/offer" \
    -X POST \
    -u "email-address:your-api-key" \
    -H "Content-Type: application/json" \
    -d '
    {
        "no_fee_amount": "500.50",
        "note": "I really want it?"
    }'

Making offer using auction id

Use this endpoint to make an offer as user specified in the buyer_email attribute.

1
2
3
4
5
6
7
8
9
curl "https://api.escrow.com/integration/2018-08-01/auction/123123/offer" \
    -X POST \
    -H "Content-Type: application/json" \
    -d '
    {
        "no_fee_amount": "500.50",
        "buyer_email": "your email",
        "note": "I really want it?"
    }'

Example Response

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
{
    "auction_id": 123123,
    "by_party": {
        "customer": "lois.dee@nomina.tor",
        "display_name": "Lois D. Nominator",
        "id": 444444,
        "role": "buyer"
    },
    "date_closed": null,
    "date_created": "2019-05-09T07:49:48.532617+00:00",
    "expiry_period": 1209600,
    "id": 12014,
    "no_fee_amount": "500.50",
    "note": "I really want it?",
    "status": {
        "accepted": false,
        "canceled": false,
        "rejected": false
    },
    "transaction_id": 1464147
}