Accounts eines Kunden

GET/v1/customers/{customerNumber}/accounts

API version

v1

Request method

GET

Operation ID

listAccountsByCustomer

---

Diese Ressource enthält eine Sammlung aller Accounts eines Kunden.

Request

• customerNumberinteger

  required

  Kundennummer

Responses

Format

application/json

Description

Eine Liste aller Accounts, die dem Kunden gehören

• Array[
  • *object
    • uidinteger
    • customerNumberinteger
    • namestring
    • activateShellboolean
    • descriptionstring

      required
    • disabledboolean
    • ipAddressesarray of object
      • Array[
        • *object
          • addressstring
          • scopestring (one of: internal, external)
          • versionnumber
          • typestring
          • relatedCertificateCommonNamestring
        ]
    • statusstring (one of: creating, updating, deleting, ready)
  ]

Content-Type: application/json

[
  {
    "uid": 123,
    "customerNumber": 123,
    "name": "string",
    "activateShell": true,
    "description": "string",
    "disabled": true,
    "ipAddresses": [
      {
        "address": "string",
        "scope": "internal",
        "version": 123,
        "type": "string",
        "relatedCertificateCommonName": "string"
      }
    ],
    "status": "creating"
  }
]

{
  "type": "array",
  "items": {
    "title": "Account",
    "required": [
      "description"
    ],
    "type": "object",
    "properties": {
      "uid": {
        "type": "integer",
        "readOnly": true
      },
      "customerNumber": {
        "type": "integer",
        "readOnly": true
      },
      "name": {
        "type": "string",
        "readOnly": true
      },
      "activateShell": {
        "type": "boolean",
        "readOnly": true
      },
      "description": {
        "type": "string"
      },
      "disabled": {
        "type": "boolean",
        "readOnly": true
      },
      "ipAddresses": {
        "type": "array",
        "readOnly": true,
        "items": {
          "title": "IpAddress",
          "type": "object",
          "properties": {
            "address": {
              "type": "string",
              "readOnly": true
            },
            "scope": {
              "type": "string",
              "readOnly": true,
              "enum": [
                "internal",
                "external"
              ]
            },
            "version": {
              "type": "number",
              "readOnly": true
            },
            "type": {
              "type": "string"
            },
            "relatedCertificateCommonName": {
              "type": "string"
            }
          }
        }
      },
      "status": {
        "type": "string",
        "readOnly": true,
        "enum": [
          "creating",
          "updating",
          "deleting",
          "ready"
        ]
      }
    }
  }
}

Usage examples

$ curl \
    --fail \
    --location \
    -H "Authorization: Bearer $MITTWALD_API_TOKEN" \
    https://api.mittwald.de/v1/customers/123/accounts?advised=true&owned=true&fields=string