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 user specified in the buyer_email attribute.

1
2
3
4
5
6
7
8
9
10
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",
        "buyer_email": "your email",
        "note": "I really want it?"
    }'

Adjust offer using auction id

Use this endpoint to adjust an offer or make a counter offer as the authenticated user using the transaction_id obtained from the previous endpoint.

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",
        "transaction_id": 12345,
        "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
}