POST /:country/listings

Creates a new listing. New listings are automatically claimed by it’s creator.

Body Parameters

A Listing model.

The first category in categories becomes the listing’s primary category, unless another category is flagged with "primary": true. See Primary category.

Response

On success returns HTTP 201 Created with the newly created Listing in the body.

On error returns an Error object.

Examples

Request

POST https://api.opendi.com/de/listings

{
    "name": "Opendi AG",
    "description": "A company full of nice people creating internet based white pages and and yellow pages.",
    "keywords": [
        "White Pages",
        "Yellow Pages",
        "Telephonenumbers",
        "Contacts",
        "Nice People"
    ],
    "address": "40 Müllerstr.",
    "zip": "80469",
    "place": "München",
    "country_code": "DE",
    "latitude": 48.1312973,
    "longitude": 11.5699438,
    "emails": [
        {
            "address": "info@opendi.com"
        }
    ],
    "phones": [
        {
            "type": "landline",
            "number": "+498001055105"
        },
        {
            "type": "landline",
            "number": "+4989189476620"
        },
        {
            "type": "fax",
            "number": "+4989189476626"
        }
    ],
    "hours": {
        "monday": [
            {
              "start": "10:00",
                "end": "17:00"
            }
        ],
        "tuesday": [
            {
                "start": "09:00",
                "end": "17:00"
            }
        ],
        "wednesday": [
            {
                "start": "09:00",
                "end": "17:00"
            }
        ],
        "thursday": [
            {
                "start": "09:00",
                "end": "17:00"
            }
        ],
        "friday": [
            {
                "start": "09:00",
                "end": "17:00"
            }
        ],
        "saturday": [],
        "sunday": []
    },
    "links": [
        {
            "type": "website",
            "url": "www.stadtbranchenbuch.com"
        },
        {
            "type": "googleplus",
            "url": "https://plus.google.com/118150864364347134043/"
        }
    ],
    "categories": [
        {
            "id": "1067",
            "name": "Steinmetze"
        },
        {
            "id": "58",
            "name": "Bestatter",
            "primary": true
        }
    ],
    "active": true
}

Response

The response will have IDs populated for the listing and every submodel such as phones, links and emails. Also, it will have the the url on which the listing is viewable.

HTTP 201 Created

{
    "id": "6874671",
    "name": "Opendi AG",
    "address": "40 Müllerstr.",
    "zip": "80469",
    "place": "München",
    "country_code": "DE",
    "latitude": 48.1312973,
    "longitude": 11.5699438,
    "keywords": [
        "Contacts",
        "White Pages",
        "Yellow Pages",
        "Telephonenumbers",
        "Nice People"
    ],
    "description": "A company full of nice people creating internet based white pages and and yellow pages.",
    "emails": [
        {
            "id": "37026",
            "address": "info@opendi.com"
        }
    ],
    "phones": [
        {
            "id": "2828447",
            "type": "landline",
            "number": "+498001055105"
        },
        {
            "id": "2828448",
            "type": "landline",
            "number": "+4989189476620"
        },
        {
            "id": "2828449",
            "type": "fax",
            "number": "+4989189476626"
        }
    ],
    "url": "http://vereinigtes-koenigreich.uk-eu-staging.opendi.com/london-colney/6874671.html",
    "hours": {
        "monday": [
            {
                "start": "10:00:00",
                "end": "17:00:00"
            }
        ],
        "tuesday": [
            {
                "start": "09:00:00",
                "end": "17:00:00"
            }
        ],
        "wednesday": [
            {
                "start": "09:00:00",
                "end": "17:00:00"
            }
        ],
        "thursday": [
            {
                "start": "09:00:00",
                "end": "17:00:00"
            }
        ],
        "friday": [
            {
                "start": "10:00:00",
                "end": "12:00:00"
            },
            {
                "start": "14:00:00",
                "end": "17:00:00"
            }
        ],
        "saturday": [],
        "sunday": []
    },
    "links": [
        {
            "id": "37027",
            "type": "website",
            "url": "www.stadtbranchenbuch.com"
        },
        {
            "id": "37028",
            "type": "googleplus",
            "url": "https://plus.google.com/118150864364347134043/"
        }
    ],
    "categories": [
        {
            "id": "58",
            "name": "Bestatter",
            "primary": true
        },
        {
            "id": "1067",
            "name": "Steinmetze",
            "primary": false
        }
    ],
    "active": true,
    "contact": null
}