---
search:
  tags:
    - Architecture
    - GET
seo:
  description: >-
    Security:… Reference for the GET
    /v1/warehouses/{warehouseId}/architectureElements/byExternalId/{externalId}
    endpoint in the Bpanda REST API (experimental).
sidebar:
  label: List a single element by external ID.
  badge: GET
title: List a single element by external ID.
type: openapi-operation
---
List a single element by external ID.
    Get the architecture element an externalId means, among what the caller may read: the draft of its lineage, or
    else its newest published version. Where several lineages carry the externalId, a working draft wins over a
    published one, then the newest.
    Does the edition of the process space not include the type of that version, the newest version of the same
    lineage whose type it does include is answered instead - the one byElementIds hands out. Covers the edition no
    version of that lineage, the element is refused with 403; another lineage carrying the same externalId is not
    offered in its place, so byExternalIds can still answer where this route refuses.

**Security:** Any user holding a Bpanda licence for the process space.

`GET /v1/warehouses/{warehouseId}/architectureElements/byExternalId/{externalId}`

**Responses**

- `200` — Found ArchitectureElement
- `403` — The edition of this process space includes no version of this element's lineage
- `404` — Warehouse not found or no readable element with this externalId

Response example, 200:

```json
{
  "conceptualClass": "ApplicationCollaboration",
  "created": {
    "at": "string",
    "by": "string"
  },
  "elementId": "string",
  "externalId": "string",
  "groups": [
    {
      "core": true,
      "description": {
        "defaultLanguage": "string",
        "translations": [
          {
            "language": "string",
            "value": "string"
          }
        ]
      },
      "key": "string",
      "label": {
        "defaultLanguage": "string",
        "translations": [
          {
            "language": "string",
            "value": "string"
          }
        ]
      }
    }
  ],
  "hasPredecessor": true,
  "id": "string",
  "lastValidation": {
    "at": "string",
    "by": "string"
  },
  "layer": "ApplicationLayer",
  "modified": {
    "at": "string",
    "by": "string"
  },
  "owners": [
    {
      "type": "GroupId",
      "value": "string"
    }
  ],
  "principalIsOwner": true,
  "properties": [
    {
      "enumKey": "string",
      "meta": {
        "core": true,
        "description": {
          "defaultLanguage": "string",
          "translations": [
            {
              "language": "string",
              "value": "string"
            }
          ]
        },
        "group": "string",
        "key": "string",
        "label": {
          "defaultLanguage": "string",
          "translations": [
            {
              "language": "string",
              "value": "string"
            }
          ]
        },
        "type": "BBCode",
        "validation": {
          "enumLiterals": [
            {
              "deprecated": true,
              "key": "string",
              "label": {
                "defaultLanguage": "string",
                "translations": [
                  {
                    "language": "string",
                    "value": "string"
                  }
                ]
              }
            }
          ],
          "literals": [
            {
              "defaultLanguage": "string",
              "translations": [
                {
                  "language": "string",
                  "value": "string"
                }
              ]
            }
          ],
          "lowerBound": "string",
          "mandatory": true,
          "upperBound": "string"
        }
      },
      "value": {
        "defaultLanguage": "string",
        "translations": [
          {
            "language": "string",
            "value": "string"
          }
        ]
      }
    }
  ],
  "published": {
    "at": "string",
    "by": "string"
  },
  "references": [
    {
      "meta": {
        "core": true,
        "description": {
          "defaultLanguage": "string",
          "translations": [
            {
              "language": "string",
              "value": "string"
            }
          ]
        },
        "group": "string",
        "key": "string",
        "label": {
          "defaultLanguage": "string",
          "translations": [
            {
              "language": "string",
              "value": "string"
            }
          ]
        },
        "multiplicity": "ExactlyOne",
        "targetClasses": [
          "string"
        ]
      },
      "target": {
        "assignedArchitectureElementRefs": [
          {
            "conceptualClass": "ApplicationCollaboration",
            "elementId": "string",
            "referenceDirection": "Bidirectional",
            "referenceKind": "Access",
            "specialization": "string"
          }
        ],
        "created": {
          "at": "string",
          "by": "string"
        },
        "linkedElements": [
          {
            "type": "string"
          }
        ],
        "modified": {
          "at": "string",
          "by": "string"
        },
        "properties": [
          {
            "enumKey": "string",
            "meta": {
              "core": true,
              "description": {
                "defaultLanguage": "string",
                "translations": [
                  {
                    "language": "string",
                    "value": "string"
                  }
                ]
              },
              "group": "string",
              "key": "string",
              "label": {
                "defaultLanguage": "string",
                "translations": [
                  {
                    "language": "string",
                    "value": "string"
                  }
                ]
              },
              "type": "BBCode",
              "validation": {
                "enumLiterals": [
                  {
                    "deprecated": true,
                    "key": "string",
                    "label": {
                      "defaultLanguage": "string",
                      "translations": [
                        {
                          "language": "string",
                          "value": "string"
                        }
                      ]
                    }
                  }
                ],
                "literals": [
                  {
                    "defaultLanguage": "string",
                    "translations": [
                      {
                        "language": "string",
                        "value": "string"
                      }
                    ]
                  }
                ],
                "lowerBound": "string",
                "mandatory": true,
                "upperBound": "string"
              }
            },
            "value": {
              "defaultLanguage": "string",
              "translations": [
                {
                  "language": "string",
                  "value": "string"
                }
              ]
            }
          }
        ],
        "relationshipId": "string"
      }
    }
  ],
  "representation": {
    "type": "string"
  },
  "specialization": "string",
  "validityState": "Draft",
  "visibility": {
    "lastChange": {
      "at": "string",
      "by": "string"
    },
    "visible": true
  }
}
```