Create a new listing

Request Information
URL POST {{basepath}}/domaincheckListing
CategoryDomain Check Listing

Description

For creating a new listing.

the request body should contain a DomaincheckListingCreateRequest object.

Returns a DomaincheckListingListResponse object.

JSON
{
    "domainname": "example1.com",
    "price": 133.7,
    "currency": "EUR",
    "whereToBuy": "https:\/\/mijndomein.nl\/tekoop\/example.com",
    "status": "available"
}

Example responses

Set a domain for sale with status available
Request Method & URL
POST {{basepath}}/domaincheckListing
Request Body:
{
    "domainname": "example1222.com",
    "price": 133.7,
    "currency": "EUR",
    "whereToBuy": "https:\/\/mijndomein.nl\/tekoop\/example.com",
    "status": "available"
}
Response Code:
200 OK
Response Body:
{
    "responseId": "mapi1_01fa434d12dd84773289f604e474d362c1b03bca",
    "listing": {
        "id": 21,
        "domainname": "example1222.com",
        "status": "available",
        "currency": "EUR",
        "price": 133.7,
        "whereToBuy": "https:\/\/mijndomein.nl\/tekoop\/example.com",
        "created": 1721213887,
        "modified": 1721213887
    }
}
Domain added
Request Method & URL
POST {{basepath}}/domaincheckListing
Request Body:
{
    "domainname": "example-new.com",
    "price": 133.7,
    "currency": "EUR",
    "whereToBuy": "https:\/\/dan.com\/example.com"
}
Response Code:
200 OK
Response Body:
{
    "responseId": "1_347d1d73f464692843c82faf10d76cfb30b30f29",
    "listing": {
        "id": 4,
        "domainname": "example-new.com",
        "status": "new",
        "currency": "EUR",
        "price": 133.7,
        "whereToBuy": "https:\/\/dan.com\/example.com",
        "created": 1648043224,
        "modified": 1648043224
    }
}
Already exists
Request Method & URL
POST {{basepath}}/domaincheckListing
Request Body:
{
    "domainname": "example.com",
    "price": 133.7,
    "currency": "EUR",
    "whereToBuy": "https:\/\/dan.com\/example.com"
}
Response Code:
409 Conflict
Response Body:
{
    "responseId": "1_be25abc619a27093ee2ca614b542a932ba2c0c7d",
    "status": "error",
    "errorCode": "already_exists",
    "errorMessage": "A listing with this name already exists"
}