Get a customer profile

GET/customers/{customerId}/

API version

v2

Request method

GET

Operation ID

customer-get-customer

---

Request

• customerIdstring

  required

  The uuid of the customer to be returned

Responses

Format

application/json

Description

The customer object

Schema documentation

• activeSuspensionobject
  • createdAtstring (date-time)

    required
• avatarRefIdstring
• categoryIdstring
• creationDatestring (date-time)

  required
• customerIdstring

  required
• customerNumberstring

  required
• executingUserRolesarray of string (one of: owner, member, accountant)
  • Array[

    the role within a customer

  • *string (one of: owner, member, accountant)

    the role within a customer

  ]

flagsarray of string (one of: agency, employee)

• Array[
• *string (one of: agency, employee)
]

isAllowedToPlaceOrdersboolean

isBannedboolean

isInDefaultOfPaymentboolean

levelOfUndeliverableDunningNoticestring (one of: first, second)

memberCountinteger (≥ 0)

required

namestring

required

ownerobject

• addressobject

  required
  • streetstring

    required
  • houseNumberstring

    required
  • citystring

    required
  • zipstring

    required
  • countryCodestring

    required

    ISO 3166-1 alpha-2 country code

  • addressPrefixstring
• companystring
• emailAddressstring (email)
• firstNamestring
• lastNamestring
• phoneNumbersarray of string
  • Array[
  • *string
  ]

salutationstring (one of: mr, ms, other)

required

titlestring

useFormalTermboolean

projectCountinteger (≥ 0)

required

vatIdstring

vatIdValidationStatestring (one of: valid, invalid, pending, unspecified)

Example

Content-Type: application/json

{
  "activeSuspension": {
    "createdAt": "2025-11-03T18:08:35.391Z"
  },
  "avatarRefId": "string",
  "categoryId": "string",
  "creationDate": "2025-11-03T18:08:35.391Z",
  "customerId": "string",
  "customerNumber": "string",
  "executingUserRoles": [
    "owner"
  ],
  "flags": [
    "agency"
  ],
  "isAllowedToPlaceOrders": true,
  "isBanned": true,
  "isInDefaultOfPayment": true,
  "levelOfUndeliverableDunningNotice": "first",
  "memberCount": 123,
  "name": "string",
  "owner": {
    "address": {
      "street": "Königsberger Straße",
      "houseNumber": "4-6",
      "city": "Espelkamp",
      "zip": "32339",
      "countryCode": "DE",
      "addressPrefix": "c/o Ada Lovelace"
    },
    "company": "string",
    "emailAddress": "email@mittwald.example",
    "firstName": "string",
    "lastName": "string",
    "phoneNumbers": [
      "string"
    ],
    "salutation": "mr",
    "title": "string",
    "useFormalTerm": true
  },
  "projectCount": 123,
  "vatId": "string",
  "vatIdValidationState": "valid"
}

JSON Schema

{
  "properties": {
    "activeSuspension": {
      "properties": {
        "createdAt": {
          "format": "date-time",
          "type": "string"
        }
      },
      "required": [
        "createdAt"
      ],
      "type": "object"
    },
    "avatarRefId": {
      "type": "string"
    },
    "categoryId": {
      "type": "string"
    },
    "creationDate": {
      "format": "date-time",
      "type": "string"
    },
    "customerId": {
      "type": "string"
    },
    "customerNumber": {
      "type": "string"
    },
    "executingUserRoles": {
      "items": {
        "description": "the role within a customer",
        "enum": [
          "owner",
          "member",
          "accountant"
        ],
        "type": "string"
      },
      "type": "array"
    },
    "flags": {
      "items": {
        "enum": [
          "agency",
          "employee"
        ],
        "type": "string"
      },
      "type": "array"
    },
    "isAllowedToPlaceOrders": {
      "type": "boolean"
    },
    "isBanned": {
      "type": "boolean"
    },
    "isInDefaultOfPayment": {
      "type": "boolean"
    },
    "levelOfUndeliverableDunningNotice": {
      "enum": [
        "first",
        "second"
      ],
      "type": "string"
    },
    "memberCount": {
      "minimum": 0,
      "type": "integer"
    },
    "name": {
      "type": "string"
    },
    "owner": {
      "properties": {
        "address": {
          "type": "object",
          "properties": {
            "street": {
              "type": "string",
              "example": "Königsberger Straße"
            },
            "houseNumber": {
              "type": "string",
              "example": "4-6"
            },
            "city": {
              "type": "string",
              "example": "Espelkamp"
            },
            "zip": {
              "type": "string",
              "example": "32339"
            },
            "countryCode": {
              "type": "string",
              "example": "DE",
              "description": "ISO 3166-1 alpha-2 country code"
            },
            "addressPrefix": {
              "type": "string",
              "example": "c/o Ada Lovelace"
            }
          },
          "required": [
            "street",
            "houseNumber",
            "city",
            "zip",
            "countryCode"
          ]
        },
        "company": {
          "type": "string"
        },
        "emailAddress": {
          "format": "email",
          "type": "string"
        },
        "firstName": {
          "type": "string"
        },
        "lastName": {
          "type": "string"
        },
        "phoneNumbers": {
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "salutation": {
          "type": "string",
          "enum": [
            "mr",
            "ms",
            "other"
          ]
        },
        "title": {
          "type": "string"
        },
        "useFormalTerm": {
          "type": "boolean"
        }
      },
      "required": [
        "address",
        "salutation"
      ],
      "type": "object"
    },
    "projectCount": {
      "minimum": 0,
      "type": "integer"
    },
    "vatId": {
      "type": "string"
    },
    "vatIdValidationState": {
      "enum": [
        "valid",
        "invalid",
        "pending",
        "unspecified"
      ],
      "type": "string"
    }
  },
  "required": [
    "customerId",
    "customerNumber",
    "name",
    "creationDate",
    "memberCount",
    "projectCount"
  ],
  "type": "object"
}

Usage examples

cURL

$ curl \
    --fail \
    --location \
    -H "Authorization: Bearer $MITTWALD_API_TOKEN" \
    https://api.mittwald.de/v2/customers/string

JavaScript SDK

import { MittwaldAPIV2Client } from "@mittwald/api-client";
import { assertStatus } from "@mittwald/api-client-commons";
  
const client = MittwaldAPIClient.newWithToken(process.env.MITTWALD_API_TOKEN);
const response = await client.customer.getCustomer({
  "customerId": "string"
});

assertStatus(response, 200);
  

PHP SDK

use \Mittwald\ApiClient\Generated\V2\Clients\Customer\GetCustomer\GetCustomerRequest;
  
$client = MittwaldAPIClient::newWithToken(getenv('MITTWALD_API_TOKEN'));

$request = (new GetCustomerRequest(
  customerId: "string"
));
$response = $client->customer()->getCustomer($request);

var_dump($response->getBody();