---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Account-API

# Account-API {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 11 Minuten Lesedauer

Die Account API stellt abzurufende Endpunkte bereit Kundenservice-Management (CSM)Account-Datensätze.
Diese API erfordert das Kundenservice-Plugin (com.sn_customerservice) und wird in bereitgestellt `Jetzt `Namespace.

Anwender benötigen die Rolle „csm_WS_Integration" für vollständigen API-Zugriff.

## Account -- GET /now/Account {#ariaid-title2}

Ruft einen angegebenen Satz von ab Kundenservice-Management (CSM)Accounts.

### URL-Format

Versionierte URL: /api/now/{api_Version}/Account

Standard-URL: /api/now/Account

### Unterstützte Anforderungsparameter

{#account-GET__entry__2}{#account-GET__version-not_optional-RESTAPI}

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: <kbd class="ph userinput">v1 </kbd>Oder <kbd class="ph userinput">v2 </kbd>. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
[Tabelle : 1. Pfad-Parameter]

{#account-GET__entry__6}{#account-GET__sysparm-limit-entry}{#account-GET__sysparm-offset-entry}{#account-GET__sysparm-query-entry}

| Name | Beschreibung |
|-|-|
| Sysparm_limit | Maximale Anzahl zurückzugebender Datensätze. Für Anforderungen, die diese Anzahl von Datensätzen überschreiten, verwenden Sie sysparm_offsetParameter zum Paginieren des Datensatzabrufs. In der Antwort der boolesche Parameter hasMoreWird zurückgegeben. Gibt an, ob weitere zurückzugebende Datensätze vorhanden sind, die die Filterkriterien erfüllen. Datentyp: Zahl Standard: 10 |
| Sysparm_Offset | Startdatensatzindex, für den mit dem Abrufen von Datensätzen begonnen werden soll. Verwenden Sie diesen Wert, um den Datensatzabruf zu paginieren. Diese Funktionalität ermöglicht den Abruf aller Datensätze, unabhängig von der Anzahl der Datensätze, in kleinen verwaltbaren Blöcken. Beispiel: Wenn Sie diesen Endpunkt zum ersten Mal aufrufen, sysparm_offsetIst auf „0" festgelegt. Um einfach alle verfügbaren Datensätze durchzublättern, verwenden Sie `Sysparm_Offset=sysparm_Offset+sysparm_limit `, Bis Sie das Ende aller Datensätze erreichen. Übergeben Sie keine negative Zahl in sysparm_offsetParameter. Datentyp: Zahl Standard: 0 |
| Sysparm_query | Codierte Abfrage, die zum Filtern des Ergebnissatzes verwendet wird. Zum Beispiel: `Sysparm_query=caller_ID=javascript:gs.getUserID()^Active=wahr` Die codierte Abfrage unterstützt Sortieren nach . Um Antworten basierend auf bestimmten Feldern zu sortieren, verwenden Sie SORTIEREN NACH Und ORDERBYDESC Klauseln in sysparm_query. Beispiel: `Sysparm_query=Active=wahr^ORDERBYNummer^ORDERBYDESCCATEGORY `Filtert alle aktiven Datensätze und ordnet die Ergebnisse zuerst in aufsteigender Reihenfolge nach Zahl und dann in absteigender Reihenfolge nach Kategorie an. Wenn ein Teil der Abfrage ungültig ist, z. B. durch Angabe eines ungültigen Feldnamens, ignoriert die Instanz den ungültigen Teil. Gibt dann Zeilen zurück, die nur den gültigen Teil der Abfrage verwenden. Sie können dieses Verhalten mithilfe der Eigenschaft steuern glide.invalid_query.returns_no_rows. Legen Sie diese Eigenschaft auf „wahr" fest, um keine Zeilen für eine ungültige Abfrage zurückzugeben. Hinweis: Die glide.invalid_query.returns_no_rowsEigenschaft steuert das Verhalten aller Abfragen in der Instanz, z. B. in Listen, Skripts ( GlideRecord.Abfrage() ) Und Webservice-APIs. Datentyp: Zeichenfolge |
[Tabelle : 2. Abfrageparameter]

{#account-GET__entry__14}

| Element | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 3. Anforderungstext-Parameter (XML oder JSON)]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#account-GET__entry__18}{#account-GET__accept-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
[Tabelle : 4. Anforderungskopfzeilen.]

{#account-GET__entry__22}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 5. Antwort-Header]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#account-GET__entry__26}{#account-GET__entry-200-status-code}{#account-GET__entry-500-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 500 | Interner Serverfehler. Beim Verarbeiten der Anforderung ist ein unerwarteter Fehler aufgetreten. Die Antwort enthält zusätzliche Informationen zum Fehler. |
[Tabelle : 6. Statuscodes]

### Antworttext-Parameter (JSON oder XML)

{#account-GET__table_pgg_h4b_1dc__entry__2}{#account-GET__accounttable-account_code-entry}{#account-GET__accounttable-account_parent-entry}{#account-GET__accounttable-account_path-entry}{#account-GET__accounttable-active_escalation-entry}{#account-GET__accounttable-apple_icon-entry}{#account-GET__accounttable-banner_image-entry}{#account-GET__accounttable-banner_image_light-entry}{#account-GET__accounttable-banner_text-entry}{#account-GET__accounttable-city-entry}{#account-GET__accounttable-contact-entry}{#account-GET__accounttable-country-entry}{#account-GET__accounttable-customer-entry}{#account-GET__accounttable-discount-entry}{#account-GET__accounttable-fax_phone-entry}{#account-GET__accounttable-fiscal_year-entry}{#account-GET__accounttable-lat_long_error-entry}{#account-GET__accounttable-latitude-entry}{#account-GET__accounttable-longitude-entry}{#account-GET__accounttable-manufactuer-entry}{#account-GET__accounttable-market_cap-entry}{#account-GET__accounttable-name-entry}{#account-GET__accounttable-notes-entry}{#account-GET__accounttable-num_employees-entry}{#account-GET__accounttable-number-entry}{#account-GET__accounttable-parent-entry}{#account-GET__accounttable-partner-entry}{#account-GET__accounttable-phone-entry}{#account-GET__accounttable-primary-entry}{#account-GET__accounttable-primary_contact-entry}{#account-GET__accounttable-profits-entry}{#account-GET__accounttable-publicly_traded-entry}{#account-GET__accounttable-rank_tier-entry}{#account-GET__accounttable-registration_code-entry}{#account-GET__accounttable-revenue_per_year-entry}{#account-GET__accounttable-state-entry}{#account-GET__accounttable-stock_price-entry}{#account-GET__accounttable-stock_symbol-entry}{#account-GET__accounttable-street-entry}{#account-GET__accounttable-sys_class_name-entry}{#account-GET__accounttable-sys_created_by-entry}{#account-GET__accounttable-sys_created_on-entry}{#account-GET__accounttable-sys_id-entry}{#account-GET__accounttable-sys_mod_count-entry}{#account-GET__accounttable-sys_updated_by-entry}{#account-GET__accounttable-sys_updated_on-entry}{#account-GET__accounttable-theme-entry}{#account-GET__accounttable-vendor-entry}{#account-GET__accounttable-vendor_manager-entry}{#account-GET__accounttable-vendor_type-entry}{#account-GET__accounttable-website-entry}{#account-GET__accounttable-zip-entry}

| Parameter | Beschreibung |
|-|-|
| Account_Code | Eindeutige Kombination von Werten, die eine Anwendung zum Identifizieren von Budgetprognosen und Budgetplänen verwendet. Datentyp: Zeichenfolge Maximale Länge: 255 |
| Account_parent | SYS_ID des übergeordneten Accounts dieses Accounts. Befindet sich in der Account-Tabelle \[Customer_Account\]. Datentyp: Zeichenfolge |
| Account_path | Pfad vom übergeordneten zu den untergeordneten Accounts in der Accounthierarchie. Datentyp: Zeichenfolge Maximale Länge: 255 |
| Active_Eskalation | SYS_ID der aktiven Eskalation, die dem Account zugeordnet ist. Datentyp: Zeichenfolge Tabelle: Eskalation \[sn_customerservice_Eskalation\] |
| apple_Symbol | Symbol für iPhone-Homepage-Lesezeichen. Datentyp: Bild |
| Banner_Image | Bannerbild, das im Kundenportal angezeigt wird. Datentyp: Bild |
| Banner_image_light | Kleines Bannerbild. Datentyp: Bild |
| Banner_Text | Bannertext, der im Kundenportal angezeigt wird. Datentyp: Zeichenfolge Maximale Länge: 4.000 |
| city | Stadt, in der das Unternehmen ansässig ist, das diesem Account zugeordnet ist. Datentyp: Zeichenfolge Maximale Länge: 50 |
| Kontakt | SYS_ID eines Kontaktdatensatzes, der diesem Account zugeordnet ist. Datentyp: Zeichenfolge Tabelle: Anwender \[sys_user\] |
| country | Land, in dem das Unternehmen ansässig ist, das diesem Account zugeordnet ist. Datentyp: Zeichenfolge Maximale Länge: 40 Standard: USA |
| Kunde | Kennzeichnung, die angibt, ob der Account ein Kundenaccount im Gegensatz zu einem Partneraccount ist. Mögliche Werte: * Wahr: Kundenaccount * Falsch: Partner-Account {#account-GET__ul_mhg_dh3_2hb} Datentyp: Boolescher Wert Standard: Falsch |
| Rabatt | Rabatt, der dem Account auf Käufe gewährt wird. Datentyp: Zahl Maximale Länge: 15 |
| Fax_Phone | Primäre Faxnummer für das Unternehmen, das diesem Account zugeordnet ist. Datentyp: Zeichenfolge Maximale Länge: 40 |
| fiscal_year | Geschäftsjahr für das dem Account zugeordnete Unternehmen. Datentyp: Zeichenfolge |
| Lat_Long_error | Unterschied des tatsächlichen Standorts im Vergleich zu Breiten- und Längengradinformationen. Datentyp: Zeichenfolge Maximale Länge: 1.000 |
| latitude | Breitengrad des Unternehmens, das diesem Account zugeordnet ist. Datentyp: Zahl (Gleitkommazahl) Maximale Länge: 40 |
| longitude | Längengrad des Unternehmens, das diesem Account zugeordnet ist. Datentyp: Zahl (Gleitkommazahl) Maximale Länge: 40 |
| manufacturer | Kennzeichnung, die angibt, ob das diesem Account zugeordnete Unternehmen Waren herstellt. Mögliche Werte: * Wahr: Stellt Waren her * Falsch: Stellt keine Waren her {#account-GET__ul_j4p_t1r_2hb} Datentyp: Boolescher Wert Standard: Falsch |
| Market_Cap | Marktwert der öffentlich gehandelten Aktien des zugehörigen Unternehmens. Datentyp: Zahl (Währung) Maximale Länge: 20 |
| name | Name des Unternehmens, das diesem Account zugeordnet ist. Datentyp: Zeichenfolge Maximale Länge: 80 |
| Notizen | Zusätzliche Informationen zum Unternehmen. Datentyp: Zeichenfolge Maximale Länge: 4.000 |
| num_Employees | Anzahl der im Unternehmen beschäftigten Personen. Datentyp: Zahl (Ganzzahl) Maximale Länge: 40 |
| Nummer | Nummer, die diesen Account identifiziert. Datentyp: Zeichenfolge Maximale Länge: 40 |
| übergeordnet | SYS_ID des übergeordneten Accounts dieses Accounts. Datentyp: Zeichenfolge Tabelle: Unternehmen \[Core_Company\] |
| Partner | Kennzeichnung, die angibt, ob der Account ein Partner-Account oder ein Kundenaccount ist. Mögliche Werte: * Wahr: Partner-Account * Falsch: Kundenaccount {#account-GET__ul_p1v_ph3_2hb} Datentyp: Boolescher Wert Standard: Falsch |
| Telefon | Primäre Telefonnummer für das Unternehmen. Datentyp: Zeichenfolge |
| primär | Kennzeichnung, die angibt, ob dies ein primärer Account ist. Mögliche Werte: * Wahr: Primärer Account * Falsch: Sekundärer Account {#account-GET__ul_ax4_sh3_2hb} Datentyp: Boolescher Wert Standard: Falsch |
| Primärer_Kontakt | SYS_ID des primären Kontakts für den Account. Datentyp: Zeichenfolge Tabelle: Kontakt \[Customer_contact\] |
| Gewinne | Gewinninformationen, die für dieses Konto eingegeben wurden. Datentyp: Zahl (Währung) Maximale Länge: 40 |
| Public_traded | Kennzeichnung, die angibt, ob das diesem Konto zugeordnete Unternehmen öffentlich an der Börse gehandelt wird. Mögliche Werte: * Wahr: Öffentlich gehandelt * Falsch: Privates Unternehmen {#account-GET__ul_e15_5h3_2hb} Datentyp: Boolescher Wert |
| Rang_Tier | Typ des Accounts. Mögliche Werte: * Schwarze Liste * sonstige * Strategisch * Taktisch * Bewertet {#account-GET__ul_cly_c33_2hb} Datentyp: Zeichenfolge Maximale Länge: 40 |
| Registrierungscode | Eindeutiger Code, den Kunden verwenden, wenn sie eine Anmeldung im Kundenportal anfordern. Dieser Code bietet eine Methode zum Validieren des Kunden im Unternehmen, bevor der Zugriff gewährt wird. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Umsatz_pro_Jahr | Umsatz, der vom Unternehmen generiert wird, das diesem Account zugeordnet ist. Datentyp: Zahl (Währung) Maximale Länge: 20 |
| Staat | Bundesland, in dem das Unternehmen ansässig ist. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Stock_price | Preis der Unternehmensaktie. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Stock_Symbol | Aktiensymbol des Unternehmens. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Straße | Straße und Hausnummer des Unternehmens. Datentyp: Zeichenfolge Maximale Länge: 255 |
| sys_class_name | Tabelle, die den zugehörigen Account-Datensatz enthält. Datentyp: Zeichenfolge |
| sys_created_by | Anwender, der den Account ursprünglich erstellt hat. Datentyp: Zeichenfolge Maximale Länge: 40 |
| sys_created_on | Datum und Uhrzeit der ursprünglichen Erstellung des Accounts. Datentyp: Zeichenfolge |
| sys_id | SYS_ID für den Account-Datensatz. Datentyp: Zeichenfolge |
| sys_mod_count | Gibt an, wie oft die Account-Informationen aktualisiert wurden. Datentyp: Zahl (Ganzzahl) |
| sys_updated_by | Anwender, der die Account-Informationen zuletzt geändert hat. Datentyp: Zeichenfolge Maximale Länge: 40 |
| sys_updated_on | Datum und Uhrzeit der letzten Aktualisierung der Account-Informationen. Datentyp: Zeichenfolge |
| Design | SYS_ID des Kundenportaldesigns, das von diesem Account verwendet wird. Datentyp: Zeichenfolge Tabelle: Design \[sys_ui_Theme\] |
| Lieferant | Kennzeichnung, die angibt, ob das diesem Account zugeordnete Unternehmen ein Lieferant ist. Mögliche Werte: * Wahr: Lieferant * Falsch: Kein Lieferant {#account-GET__ul_tqf_333_2hb} Datentyp: Boolescher Wert Standard: Falsch |
| Vendor_Manager | Liste der sys_IDs der Lieferantenmanager für den Account. Datentyp: Zeichenfolge Tabelle: Anwender \[sys_user\] |
| Vendor_type | Liste der sys_IDs des Lieferantentyps, z. B. Anwendungen, Hardware, Services oder Software. Datentyp: Zeichenfolge Tabelle: Lieferantentyp \[Vendor_type\] |
| Website | URL der Website für das Unternehmen. Datentyp: Zeichenfolge Maximale Länge: 1.024 |
| Postleitzahl | Postleitzahl des Unternehmens. Datentyp: Zeichenfolge Maximale Länge: 40 |
[ ]

{#account-GET__table_pgg_h4b_1dc}  

### Curl-Anforderung

    curl "https://instance.servicenow.com/api/now/account?sysparm_limit=2&sysparm_offset=2>;rel="next" \
    --request GET \
    --header "Accept:application/json" \
    --user 'username':'password'

    {
    "result": [
      {
       "banner_image_light": "",
       "country": "USA",
       "parent": "",
       "notes": "",
       "stock_symbol": "",
       "discount": "",
       "active_escalation": "",
       "sys_updated_on": "2019-01-03 19:37:55",
       "apple_icon": "",
       "number": "ACCT0000003",
        "sys_updated_by": "admin",
        "fiscal_year": "",
        "sys_created_on": "2018-12-23 05:25:17",
        "contact": "",
        "stock_price": "",
        "state": "",
        "banner_image": "",
        "sys_created_by": "admin",
        "longitude": "",
        "zip": "BR1 3QR",
        "profits": "0",
        "phone": "+44 20 8466 9992",
        "fax_phone": "",
        "name": "Boxeo EMEA",
        "banner_text": "",
        "account_code": "~~~~3",
        "primary": "false",
        "city": "Bromley",
        "latitude": "",
        "sys_class_name": "customer_account",
        "manufacturer": "false",
        "account_parent": "86837a386f0331003b3c498f5d3ee4ca",
        "sys_id": "3eedd08413651200042ab3173244b088",
        "market_cap": "0",
        "num_employees": "",
        "rank_tier": "",
        "street": "18 London Rd",
        "vendor": "false",
        "lat_long_error": "",
        "theme": "",
        "vendor_type": "",
        "website": "",
        "revenue_per_year": "0",
        "publicly_traded": "false",
        "sys_mod_count": "5",
        "sys_tags": "",
        "partner": "false",
        "registration_code": "BOXEO-EMEA",
        "vendor_manager": "",
        "account_path": "~~~~1/~~~~3",
        "primary_contact": "ff66c1254fb81200025ba3618110c76e",
        "customer": "true"
      },
      {
        "banner_image_light": "",
        "country": "USA",
        "parent": "",
        "notes": "",
        "stock_symbol": "",
        "discount": "",
        "active_escalation": "",
        "sys_updated_on": "2019-01-03 19:38:04",
        "apple_icon": "",
        "number": "ACCT0000004",
        "sys_updated_by": "admin",
        "fiscal_year": "",
        "sys_created_on": "2018-12-23 05:19:24",
        "contact": "",
        "stock_price": "",
        "state": "",
        "banner_image": "",
        "sys_created_by": "admin",
        "longitude": "",
        "zip": "V5L 2G4",
        "profits": "0",
        "phone": "+1 604-255-9797",
        "fax_phone": "",
        "name": "Boxeo Canada",
        "banner_text": "",
        "account_code": "~~~~4",
        "primary": "false",
        "city": "Vancouver",
        "latitude": "",
        "sys_class_name": "customer_account",
        "manufacturer": "false",
        "account_parent": "86837a386f0331003b3c498f5d3ee4ca",
        "sys_id": "609cd80413651200042ab3173244b03e",
        "market_cap": "0",
        "num_employees": "",
        "rank_tier": "",
        "street": "1362 Venables St,, BC V5L 2G4, Canada",
        "vendor": "false",
        "lat_long_error": "",
        "theme": "",
        "vendor_type": "",
        "website": "",
        "revenue_per_year": "0",
        "publicly_traded": "false",
        "sys_mod_count": "5",
        "sys_tags": "",
        "partner": "false",
        "registration_code": "BOXEO-CANADA",
        "vendor_manager": "",
        "account_path": "~~~~1/~~~~4",
        "primary_contact": "c07424a54f781200025ba3618110c746",
        "customer": "true"
      }
     ]
    }

## Account -- GET /now/Account/{ID} {#ariaid-title3}

Ruft die angegebene ab Kundenservice-Management (CSM)Account.

### URL-Format

Versionierte URL: /api/now/{api_Version}/Account/{ID}

Standard-URL: /api/now/Account/{ID}

### Unterstützte Anforderungsparameter

{#account-GET-id__entry__2}{#account-GET-id__version-not_optional-RESTAPI}

| Name | Beschreibung |
|-|-|
| api_version | Optional. Version des Endpunkts, auf den zugegriffen werden soll. Beispiel: <kbd class="ph userinput">v1 </kbd>Oder <kbd class="ph userinput">v2 </kbd>. Geben Sie diesen Wert nur an, um eine andere Endpunktversion als die neueste zu verwenden. Datentyp: Zeichenfolge |
| ID | SYS_ID des abzurufenden Accounts. Befindet sich in der Tabelle „Kunde" \[Customer_Account\]. Datentyp: Zeichenfolge |
[Tabelle : 7. Pfad-Parameter]

{#account-GET-id__entry__8}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 8. Abfrageparameter]

{#account-GET-id__entry__12}

| Name | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 9. Anforderungstext-Parameter (XML oder JSON)]

### Header

Die folgenden Anforderungs- und Antwort-Header gelten nur für diese HTTP-Aktion oder werden auf diese Aktion in einer bestimmten Weise angewendet. Eine Liste der allgemeinen Header, die in der REST-API verwendet werden, finden Sie unter [Unterstützte REST-API-Header](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#account-GET-id__entry__16}{#account-GET-id__accept-RESTAPI}

| Header | Beschreibung |
|-|-|
| Akzeptieren | Datenformat des Antworttexts. Unterstützte Typen: application/jsonOder application/xml. Standard: application/json |
[Tabelle : 10. Anforderungskopfzeilen.]

{#account-GET-id__entry__20}

| Header | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 11. Antwort-Header]

### Statuscodes

Die folgenden Statuscodes gelten für diese HTTP-Aktion. Eine Liste der möglichen Statuscodes, die in der REST-API verwendet werden, finden Sie unter [REST-API-HTTP-Antwortcodes](https://servicenow-prod.fluidtopics.net/ai2El07oZMsuDDSV75uftQ "REST (repräsentative Statusübertragung) ist eine einfache statuslose Architektur, die Standards zwischen Computersystemen im Web bereitstellt, wodurch sie leichter miteinander kommunizieren können.").
{#account-GET-id__entry__24}{#account-GET-id__entry-200-status-code}

| Statuscode | Beschreibung |
|-|-|
| 200 | Erfolgreich. Die Anforderung wurde erfolgreich verarbeitet. |
| 404 | Gibt an, dass die Anforderung ungültig ist.i89 Mögliche Ursache: * Angeforderter Fall ist nicht vorhanden. * Anwender hat keinen Zugriff auf den Account-Datensatz. {#account-GET-id__ul_ubm_1jl_3v} |
[Tabelle : 12. Statuscodes]

### Antworttext-Parameter (JSON oder XML) {#account-GET-id__section_kgc_mpb_1dc}

{#account-GET-id__table_pgg_h4b_1dc__entry__2}{#account-GET-id__accounttable-account_code-entry}{#account-GET-id__accounttable-account_parent-entry}{#account-GET-id__accounttable-account_path-entry}{#account-GET-id__accounttable-active_escalation-entry}{#account-GET-id__accounttable-apple_icon-entry}{#account-GET-id__accounttable-banner_image-entry}{#account-GET-id__accounttable-banner_image_light-entry}{#account-GET-id__accounttable-banner_text-entry}{#account-GET-id__accounttable-city-entry}{#account-GET-id__accounttable-contact-entry}{#account-GET-id__accounttable-country-entry}{#account-GET-id__accounttable-customer-entry}{#account-GET-id__accounttable-discount-entry}{#account-GET-id__accounttable-fax_phone-entry}{#account-GET-id__accounttable-fiscal_year-entry}{#account-GET-id__accounttable-lat_long_error-entry}{#account-GET-id__accounttable-latitude-entry}{#account-GET-id__accounttable-longitude-entry}{#account-GET-id__accounttable-manufactuer-entry}{#account-GET-id__accounttable-market_cap-entry}{#account-GET-id__accounttable-name-entry}{#account-GET-id__accounttable-notes-entry}{#account-GET-id__accounttable-num_employees-entry}{#account-GET-id__accounttable-number-entry}{#account-GET-id__accounttable-parent-entry}{#account-GET-id__accounttable-partner-entry}{#account-GET-id__accounttable-phone-entry}{#account-GET-id__accounttable-primary-entry}{#account-GET-id__accounttable-primary_contact-entry}{#account-GET-id__accounttable-profits-entry}{#account-GET-id__accounttable-publicly_traded-entry}{#account-GET-id__accounttable-rank_tier-entry}{#account-GET-id__accounttable-registration_code-entry}{#account-GET-id__accounttable-revenue_per_year-entry}{#account-GET-id__accounttable-state-entry}{#account-GET-id__accounttable-stock_price-entry}{#account-GET-id__accounttable-stock_symbol-entry}{#account-GET-id__accounttable-street-entry}{#account-GET-id__accounttable-sys_class_name-entry}{#account-GET-id__accounttable-sys_created_by-entry}{#account-GET-id__accounttable-sys_created_on-entry}{#account-GET-id__accounttable-sys_id-entry}{#account-GET-id__accounttable-sys_mod_count-entry}{#account-GET-id__accounttable-sys_updated_by-entry}{#account-GET-id__accounttable-sys_updated_on-entry}{#account-GET-id__accounttable-theme-entry}{#account-GET-id__accounttable-vendor-entry}{#account-GET-id__accounttable-vendor_manager-entry}{#account-GET-id__accounttable-vendor_type-entry}{#account-GET-id__accounttable-website-entry}{#account-GET-id__accounttable-zip-entry}

| Parameter | Beschreibung |
|-|-|
| Account_Code | Eindeutige Kombination von Werten, die eine Anwendung zum Identifizieren von Budgetprognosen und Budgetplänen verwendet. Datentyp: Zeichenfolge Maximale Länge: 255 |
| Account_parent | SYS_ID des übergeordneten Accounts dieses Accounts. Befindet sich in der Account-Tabelle \[Customer_Account\]. Datentyp: Zeichenfolge |
| Account_path | Pfad vom übergeordneten zu den untergeordneten Accounts in der Accounthierarchie. Datentyp: Zeichenfolge Maximale Länge: 255 |
| Active_Eskalation | SYS_ID der aktiven Eskalation, die dem Account zugeordnet ist. Datentyp: Zeichenfolge Tabelle: Eskalation \[sn_customerservice_Eskalation\] |
| apple_Symbol | Symbol für iPhone-Homepage-Lesezeichen. Datentyp: Bild |
| Banner_Image | Bannerbild, das im Kundenportal angezeigt wird. Datentyp: Bild |
| Banner_image_light | Kleines Bannerbild. Datentyp: Bild |
| Banner_Text | Bannertext, der im Kundenportal angezeigt wird. Datentyp: Zeichenfolge Maximale Länge: 4.000 |
| city | Stadt, in der das Unternehmen ansässig ist, das diesem Account zugeordnet ist. Datentyp: Zeichenfolge Maximale Länge: 50 |
| Kontakt | SYS_ID eines Kontaktdatensatzes, der diesem Account zugeordnet ist. Datentyp: Zeichenfolge Tabelle: Anwender \[sys_user\] |
| country | Land, in dem das Unternehmen ansässig ist, das diesem Account zugeordnet ist. Datentyp: Zeichenfolge Maximale Länge: 40 Standard: USA |
| Kunde | Kennzeichnung, die angibt, ob der Account ein Kundenaccount im Gegensatz zu einem Partneraccount ist. Mögliche Werte: * Wahr: Kundenaccount * Falsch: Partner-Account {#account-GET-id__ul_mhg_dh3_2hb} Datentyp: Boolescher Wert Standard: Falsch |
| Rabatt | Rabatt, der dem Account auf Käufe gewährt wird. Datentyp: Zahl Maximale Länge: 15 |
| Fax_Phone | Primäre Faxnummer für das Unternehmen, das diesem Account zugeordnet ist. Datentyp: Zeichenfolge Maximale Länge: 40 |
| fiscal_year | Geschäftsjahr für das dem Account zugeordnete Unternehmen. Datentyp: Zeichenfolge |
| Lat_Long_error | Unterschied des tatsächlichen Standorts im Vergleich zu Breiten- und Längengradinformationen. Datentyp: Zeichenfolge Maximale Länge: 1.000 |
| latitude | Breitengrad des Unternehmens, das diesem Account zugeordnet ist. Datentyp: Zahl (Gleitkommazahl) Maximale Länge: 40 |
| longitude | Längengrad des Unternehmens, das diesem Account zugeordnet ist. Datentyp: Zahl (Gleitkommazahl) Maximale Länge: 40 |
| manufacturer | Kennzeichnung, die angibt, ob das diesem Account zugeordnete Unternehmen Waren herstellt. Mögliche Werte: * Wahr: Stellt Waren her * Falsch: Stellt keine Waren her {#account-GET-id__ul_j4p_t1r_2hb} Datentyp: Boolescher Wert Standard: Falsch |
| Market_Cap | Marktwert der öffentlich gehandelten Aktien des zugehörigen Unternehmens. Datentyp: Zahl (Währung) Maximale Länge: 20 |
| name | Name des Unternehmens, das diesem Account zugeordnet ist. Datentyp: Zeichenfolge Maximale Länge: 80 |
| Notizen | Zusätzliche Informationen zum Unternehmen. Datentyp: Zeichenfolge Maximale Länge: 4.000 |
| num_Employees | Anzahl der im Unternehmen beschäftigten Personen. Datentyp: Zahl (Ganzzahl) Maximale Länge: 40 |
| Nummer | Nummer, die diesen Account identifiziert. Datentyp: Zeichenfolge Maximale Länge: 40 |
| übergeordnet | SYS_ID des übergeordneten Accounts dieses Accounts. Datentyp: Zeichenfolge Tabelle: Unternehmen \[Core_Company\] |
| Partner | Kennzeichnung, die angibt, ob der Account ein Partner-Account oder ein Kundenaccount ist. Mögliche Werte: * Wahr: Partner-Account * Falsch: Kundenaccount {#account-GET-id__ul_p1v_ph3_2hb} Datentyp: Boolescher Wert Standard: Falsch |
| Telefon | Primäre Telefonnummer für das Unternehmen. Datentyp: Zeichenfolge |
| primär | Kennzeichnung, die angibt, ob dies ein primärer Account ist. Mögliche Werte: * Wahr: Primärer Account * Falsch: Sekundärer Account {#account-GET-id__ul_ax4_sh3_2hb} Datentyp: Boolescher Wert Standard: Falsch |
| Primärer_Kontakt | SYS_ID des primären Kontakts für den Account. Datentyp: Zeichenfolge Tabelle: Kontakt \[Customer_contact\] |
| Gewinne | Gewinninformationen, die für dieses Konto eingegeben wurden. Datentyp: Zahl (Währung) Maximale Länge: 40 |
| Public_traded | Kennzeichnung, die angibt, ob das diesem Konto zugeordnete Unternehmen öffentlich an der Börse gehandelt wird. Mögliche Werte: * Wahr: Öffentlich gehandelt * Falsch: Privates Unternehmen {#account-GET-id__ul_e15_5h3_2hb} Datentyp: Boolescher Wert |
| Rang_Tier | Typ des Accounts. Mögliche Werte: * Schwarze Liste * sonstige * Strategisch * Taktisch * Bewertet {#account-GET-id__ul_cly_c33_2hb} Datentyp: Zeichenfolge Maximale Länge: 40 |
| Registrierungscode | Eindeutiger Code, den Kunden verwenden, wenn sie eine Anmeldung im Kundenportal anfordern. Dieser Code bietet eine Methode zum Validieren des Kunden im Unternehmen, bevor der Zugriff gewährt wird. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Umsatz_pro_Jahr | Umsatz, der vom Unternehmen generiert wird, das diesem Account zugeordnet ist. Datentyp: Zahl (Währung) Maximale Länge: 20 |
| Staat | Bundesland, in dem das Unternehmen ansässig ist. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Stock_price | Preis der Unternehmensaktie. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Stock_Symbol | Aktiensymbol des Unternehmens. Datentyp: Zeichenfolge Maximale Länge: 40 |
| Straße | Straße und Hausnummer des Unternehmens. Datentyp: Zeichenfolge Maximale Länge: 255 |
| sys_class_name | Tabelle, die den zugehörigen Account-Datensatz enthält. Datentyp: Zeichenfolge |
| sys_created_by | Anwender, der den Account ursprünglich erstellt hat. Datentyp: Zeichenfolge Maximale Länge: 40 |
| sys_created_on | Datum und Uhrzeit der ursprünglichen Erstellung des Accounts. Datentyp: Zeichenfolge |
| sys_id | SYS_ID für den Account-Datensatz. Datentyp: Zeichenfolge |
| sys_mod_count | Gibt an, wie oft die Account-Informationen aktualisiert wurden. Datentyp: Zahl (Ganzzahl) |
| sys_updated_by | Anwender, der die Account-Informationen zuletzt geändert hat. Datentyp: Zeichenfolge Maximale Länge: 40 |
| sys_updated_on | Datum und Uhrzeit der letzten Aktualisierung der Account-Informationen. Datentyp: Zeichenfolge |
| Design | SYS_ID des Kundenportaldesigns, das von diesem Account verwendet wird. Datentyp: Zeichenfolge Tabelle: Design \[sys_ui_Theme\] |
| Lieferant | Kennzeichnung, die angibt, ob das diesem Account zugeordnete Unternehmen ein Lieferant ist. Mögliche Werte: * Wahr: Lieferant * Falsch: Kein Lieferant {#account-GET-id__ul_tqf_333_2hb} Datentyp: Boolescher Wert Standard: Falsch |
| Vendor_Manager | Liste der sys_IDs der Lieferantenmanager für den Account. Datentyp: Zeichenfolge Tabelle: Anwender \[sys_user\] |
| Vendor_type | Liste der sys_IDs des Lieferantentyps, z. B. Anwendungen, Hardware, Services oder Software. Datentyp: Zeichenfolge Tabelle: Lieferantentyp \[Vendor_type\] |
| Website | URL der Website für das Unternehmen. Datentyp: Zeichenfolge Maximale Länge: 1.024 |
| Postleitzahl | Postleitzahl des Unternehmens. Datentyp: Zeichenfolge Maximale Länge: 40 |
[ ]

{#account-GET-id__table_pgg_h4b_1dc}  

### Curl-Anforderung

    curl "https://instance.servicenow.com/api/now/account/bf60bef46f0331003b3c498f5d3ee41a" \
    --request GET \
    --header "Accept:application/json" \
    --user "username":"password"

    {
    "result": {
      "banner_image_light": "",
      "country": "USA",
      "parent": "",
      "notes": "",
      "stock_symbol": "",
      "discount": "",
      "active_escalation": "e4fa242887150300fe4433d4c6cb0b5f",
      "sys_updated_on": "2020-07-30 21:57:54",
      "apple_icon": "",
      "number": "ACCT0000009",
      "sys_updated_by": "admin",
      "fiscal_year": "",
      "sys_created_on": "2019-09-16 21:19:27",
      "contact": "bea1fef46f0331003b3c498f5d3ee4c5",
      "stock_price": "",
      "state": "California",
      "banner_image": "",
      "sys_created_by": "venki",
      "longitude": "-122.116445",
      "zip": "94022",
      "profits": "0",
      "phone": "(877) 729-4269",
      "fax_phone": "",
      "name": "Avid Corporation",
      "banner_text": "",
      "account_code": "~~~~9",
      "primary": "false",
      "city": "Los Altos",
      "latitude": "37.402666",
      "sys_class_name": "customer_account",
      "manufacturer": "false",
      "account_parent": "",
      "sys_id": "bf60bef46f0331003b3c498f5d3ee41a",
      "market_cap": "0",
      "num_employees": "",
      "rank_tier": "",
      "street": "4440 El Camino Real",
      "vendor": "false",
      "lat_long_error": "",
      "theme": "",
      "vendor_type": "",
      "website": "http://www.avidcorp.com",
      "revenue_per_year": "0",
      "publicly_traded": "false",
      "sys_mod_count": "10",
      "sys_tags": "",
      "partner": "false",
      "registration_code": "AVID",
      "vendor_manager": "",
      "account_path": "~~~~9",
      "primary_contact": "bea1fef46f0331003b3c498f5d3ee4c5",
      "customer": "true"
     }
    }


