---
updatedAt: 2025-09-09T22:38:05.000Z
agentTools:
  projectIndex: https://docs.smartlane.ai/llms.txt
---

# Address

Adds a new customer address to the address database. The new address can then be searched via /searchaddres. If no location (latitude/longitude) is given in the request, the address will automatically be geocoded and located on the map.

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "Smartlane OpenAPI Description",
    "description": "Smartlane Transport Intelligence API endpoints specification",
    "version": "1.1"
  },
  "servers": [
    {
      "url": "https://customer_id.prod.smartlane.io/api"
    }
  ],
  "security": [
    {
      "jwt": []
    }
  ],
  "tags": [
    {
      "name": "Address",
      "description": ""
    }
  ],
  "paths": {
    "/address": {
      "post": {
        "tags": [
          "Address"
        ],
        "summary": "Address",
        "description": "Adds a new customer address to the address database. The new address can then be searched via /searchaddres. If no location (latitude/longitude) is given in the request, the address will automatically be geocoded and located on the map.\n",
        "operationId": "postAddress",
        "requestBody": {
          "description": "Address object.",
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/Address"
              }
            }
          },
          "required": false
        },
        "responses": {
          "200": {
            "description": "OK.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Address"
                }
              }
            }
          },
          "403": {
            "description": "An error message caused by missing authorization (403 forbidden).",
            "content": {
              "application/json": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "422": {
            "description": "An error message caused by unprocessable input (e.g. no data found for input parameters).",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "default": {
            "description": "Unexpected error.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-codegen-request-body-name": "body"
      }
    }
  },
  "components": {
    "schemas": {
      "Location": {
        "type": "object",
        "properties": {
          "coordinates": {
            "type": "array",
            "items": {
              "type": "number"
            }
          },
          "type": {
            "type": "string"
          }
        }
      },
      "Address": {
        "type": "object",
        "properties": {
          "id": {
            "type": "integer"
          },
          "city": {
            "type": "string"
          },
          "contactcompany": {
            "type": "string"
          },
          "customernr": {
            "type": "string"
          },
          "contactfirstname": {
            "type": "string"
          },
          "contactlastname": {
            "type": "string"
          },
          "country": {
            "type": "string"
          },
          "district": {
            "type": "string"
          },
          "email": {
            "type": "string"
          },
          "housenumber": {
            "type": "string"
          },
          "location": {
            "$ref": "#/components/schemas/Location"
          },
          "phonenr": {
            "type": "string"
          },
          "postalcode": {
            "type": "string"
          },
          "street": {
            "type": "string"
          }
        }
      },
      "Error": {
        "type": "object",
        "properties": {
          "err_id": {
            "type": "string",
            "description": "Identifier of the occurring error which can be used to report and debug the cause of the error."
          },
          "status": {
            "type": "integer",
            "description": "HTTP status code of the error.",
            "format": "int32"
          },
          "message": {
            "type": "string",
            "description": "Descriptive error message."
          },
          "notes": {
            "type": "array",
            "description": "Additional notes for certain data sets causing the error.",
            "items": {
              "type": "string"
            }
          },
          "success": {
            "type": "boolean",
            "description": "Indicates if the request might have succeeded despite the error."
          },
          "argo_failure": {
            "type": "string",
            "description": "Indicates if Argo is the cause of the error."
          }
        }
      }
    },
    "securitySchemes": {
      "jwt": {
        "type": "apiKey",
        "name": "jwt",
        "in": "header"
      }
    }
  },
  "x-explorer-enabled": false,
  "x-samples-languages": [
    "curl",
    "python",
    "java",
    "node",
    "javascript"
  ],
  "x-readme": {
    "proxy-enabled": true
  }
}
```