Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

This endpoint is used to create new address by passing JSON request payload.

...

https://api.bbamastro.com.au/address🔗

...

Request Payload

Field

Data Type

Name

Required

Description

Schema

company

Body

String

address

Yes

optional

Address request payload

AddressPayload

Responses

...

HTTP Code

...

Description

...

Schema

...

200

...

OK

...

AddressPublicProjection

...

201

...

Created

...

No Content

...

401

...

Unauthorized

...

No Content

...

403

...

Forbidden

...

No Content

...

404

...

Not Found

...

No Content

Definitions

mykey

Type: apiKey

Name: Authorization

In: HEADER

AddressPayload

Name

Description

Schema

addressLine1

optional

Address line 1

string

addressLine2

optional

Company name

firstName

String

Yes

First name

lastName

String

Yes

Last name

addressLine1

String

Yes

Address line 1

addressLine2

String

No

Address line 2

string

location

companystring

Long

optional

Address company name

string

customerCarrierAccountCode

optional

Customer carrier account code

Yes

Location id

phone

String

Yes

Phone number

email

optional

String

Address email

Name

Description

Schema

addressLine1

optional

Address line 1

string

addressLine2

optional

Address line 2

string

company

optional

Address company name

string

customerCarrierAccountCode

optional

Yes

string

firstName

optional

Address first name

string

lastName

optional

Address last name

string

location

optional

Location identifier

integer (int64)

notes

optional

Address notes

string

phone

optional

Address phone number

string

senderCode

optional

Sender code

string

AddressPublicProjection

Email address

Request Payload Sample

Code Block
{
    "company": "Test company",
    "firstName": "John",
    "lastName": "Doe",
    "addressLine1": "Test address 1",
    "addressLine2": null,
    "location": 1549606,
    "phone": "12334",
    "email": "john.doe@mailinator.com"
}

Response statuses

HTTP Code

Description

Schema

200

OK

AddressPublicProjection

201

Created

No Content

401

Unauthorized

No Content

403

Forbidden

No Content

404

Not Found

No Content

Response Payload

Field

Data Type

Description

addressLine1

string

Address line 1

addressLine2

string

Address line 2

company

string

Address company name

customerCarrierAccountCode

string

Customer carrier account code

string

email

optional

string

Address email

string

firstName

optional

string

Address first name

string

id

optional

Long

Address identifier

integer (int64)

lastName

optional

string

Address last name

string

latitude

optional

decimal

Address latitude

number (double)

location

optional

Object

Location identifier

Location

longitude

optional

decimal

Address longitude

number (double)

notes

optional

string

Address notes

string

phone

optional

string

Address phone number

string

Response Payload Sample

Code Block
{
    "notes": null,
    "firstName": "John",
    "lastName": "Doe",
    "addressLine1": "Test address 1",
    "addressLine2": null,
    "phone": "12334",
    "email": "john.doe@mailinator.com",
    "company": "Test company 999",
    "senderCode": null,
    "receiverCode": null,
    "latitude": 54.204836,
    "longitude": 37.6184915,
    "customerCarrierAccountCode": null,
    "location": {
        "id": 1549606,
        "name": "Tula",
        "code": "300000",
        "country": {
            "id": 174,
            "name": "Russian Federation",
            "code": "RU",
            "enabled": true
        },
        "state": null,
        "latitude": null,
        "longitude": null,
        "zoneId": null,
        "enabled": true,
        "oldLocation": {
            "id": 1549606,
            "name": "Tula",
            "code": "300000",
            "country": {
                "id": 174,
                "name": "Russian Federation",
                "code": "RU",
                "enabled": true
            },
            "state": null,
            "latitude": null,
            "longitude": null,
            "zoneId": null,
            "enabled": true,
            "oldLocation": null
        }
    },
    "id": 2586750
}
Info

Please refer to the Additional Reference section for more information on BBA Integration API objects.