---
sourceDocument: 호주 API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# HR REST API

# HR REST API {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 8분

HR REST API는 미국에서 일하거나 거주하는 직원에 대한 정보를 반환하는 엔드포인트를 제공합니다.

이 API에 액세스하려면 sn_hr_core.usa_employee_only 역할과 인사 관리 범위 지정 앱: 코어(com_sn_hr_core) 플러그인이 활성화되어 있어야 합니다.

## HR REST - 가져오기/get_usa_employee_profile {#ariaid-title2}

미국에 기반을 둔 직원에 대한 직원 프로파일 정보를 반환합니다.
반환되는 정보는 다음 중 하나일 수 있습니다.

* 지정된 직원 ID에 대한 직원 프로파일 정보입니다.
* 지정된 날짜 또는 이후에 추가되었거나 정보가 업데이트된 직원에 대한 정보입니다.

{#hr_rest-get_usa_employee_profile__ul_eff_mh4_yjb}  
주:  
직원을 반환 결과에 포함하려면 이 엔드포인트에 직장 또는 거주 국가를 미국으로 지정해야 합니다.  
또한 엔드포인트는 다음 매개변수를 통합 CIC Plus 애플리케이션으로 전송합니다(설명은 반환 섹션 참조).

* 직원 식별자
* 이름
* 중간 이름
* 성
* 이메일
* 작업 주소
* 워크시티
* 작업 상태
* 작업 우편번호
* 작업 국가
* 집 주소
* 구정도시
* 홈 스테이트
* HomePostalCode
* 국가(집)
* 생년월일
* HireDate
{#hr_rest-get_usa_employee_profile__ul_fr5_d5y_ljb}

### URL 형식 {#hr_rest-get_usa_employee_profile__section_f32_yvy_cmb}

기본 URL: /api/sn_hr_core/hr_rest_api/get_usa_employee_profile

### 지원되는 요청 매개변수

{#hr_rest-get_usa_employee_profile__entry__2}

| 이름 | 설명 |
|-|-|
| 없음 |   |
[표 1. 경로 매개변수]

{#hr_rest-get_usa_employee_profile__entry__6}

| 매개변수 | 설명 |
|-|-|
| employee_identifier | 직원의 고유 식별자입니다. 호출 시스템은 이 값을 생성하며 시스템과 일치하는 형식을 사용할 수 있습니다. 이 값을 얻으려면 먼저 매개변수를 사용하여 엔드포인트를 호출합니다 updated_after . 주: 이 매개변수는 매개변수와 updated_after 상호 배타적입니다. 이 매개변수는 고유한 직원을 정의하고 지정된 날짜 이후에 생성/업데이트된 직원 그룹을 반환합니다 updated_after . 데이터 유형: 문자열 |
| sysparm_limit | 반환할 최대 기록 수입니다. 이 기록 수를 초과하는 요청의 경우 매개변수를 sysparm_offset 사용하여 기록 검색을 페이지 매김합니다. 데이터 유형: 숫자 기본값: 1000 |
| sysparm_offset | 기록 검색을 시작할 기록 인덱스를 시작하는 중입니다. 이 값을 사용하여 기록 검색을 페이지 매김합니다. 이 기능을 사용하면 기록 수에 관계없이 관리 가능한 작은 청크로 모든 기록을 검색할 수 있습니다. 예를 들어 이 엔드포인트 sysparm_offset 를 처음 호출할 때 '0'으로 설정됩니다. 사용 가능한 모든 기록을 간단히 페이지화하려면 모든 기록의 끝에 도달할 때까지 `sysparm_offset=sysparm_offset+sysparm_limit`를 사용합니다. |
| updated_after | 반환할 직원 데이터를 결정하는 데 사용할 날짜입니다. 인스턴스에 추가되었거나 이 날짜 또는 그 이후에 정보가 업데이트된 모든 미국 기반 직원(직장 또는 집)이 반환 결과에 포함됩니다. 주: 이 매개변수는 매개변수와 employee_identifier 상호 배타적입니다. 데이터 유형: 문자열 형식: YYYY-MM-DD HH:MM:SS 또는 YYYY-MM-DD(시간 기본값은 00:00:00) |
[표 2. 쿼리 매개변수]

{#hr_rest-get_usa_employee_profile__entry__16}

| 이름 | 설명 |
|-|-|
| 안 함 |   |
[표 3. 요청 본문 매개변수(XML 또는 JSON)]

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#hr_rest-get_usa_employee_profile__entry__20}{#hr_rest-get_usa_employee_profile__accept-RESTAPI}

| 머리글 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json |
[표 4. 요청 헤더]

{#hr_rest-get_usa_employee_profile__entry__24}

| 머리글 | 설명 |
|-|-|
| 다음 페이지 | 후속 호출에서 가져올 추가 데이터가 있는지 여부를 나타내는 플래그입니다. 예를 들어 검색 기준과 일치하는 직원 기록이 총 120개 있고 sysparm_limit가 100으로 설정된 경우 Next-Page True입니다. 사용할 수 있는 추가 결과가 없으면 false Next-Page 입니다. 유효한 값은 다음과 같습니다. * true: 추가 데이터를 사용할 수 있습니다. 다음 데이터 청크를 얻으려면 다른 호출을 수행해야 합니다. * false: 추가 데이터가 없습니다. {#hr_rest-get_usa_employee_profile__ul_w23_2pc_4jb} |
[표 5. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#hr_rest-get_usa_employee_profile__entry__28}{#hr_rest-get_usa_employee_profile__entry-401-status-code}{#hr_rest-get_usa_employee_profile__entry-404-status-code}{#hr_rest-get_usa_employee_profile__entry-500-status-code}

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 404 | 찾을 수 없습니다. 요청한 항목을 찾을 수 없습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 6. 상태 코드]

### 응답 본문 매개변수(JSON 또는 XML)

{#hr_rest-get_usa_employee_profile__entry__38}

| 요소 | 설명 |
|-|-|
| 생년월일 | 직원의 생년월일입니다. 데이터 유형: 문자열 |
| 회사 | 회사 이름입니다. 데이터 유형: 문자열 |
| 이메일 | 직원의 이메일 주소입니다. 데이터 유형: 문자열 |
| 직원 식별자 | 고유 직원 식별자입니다. 데이터 유형: 문자열 |
| 이름 | 직원의 이름입니다. 데이터 유형: 문자열 |
| HireDate | 직원이 고용된 날짜입니다. 데이터 유형: 문자열 |
| 성 | 직원의 성입니다. 데이터 유형: 문자열 |
| 중간 이름 | 직원의 중간 이름입니다. 데이터 유형: 문자열 |
| 재고용 | 나중에 사용할 수 있습니다. 데이터 유형: 문자열 |
| 거주지 주소 | 직원의 집 주소입니다. 데이터 유형: 문자열 |
| 레지던스시티 | 직원의 거주 도시입니다. 데이터 유형: 문자열 |
| 거주지 국가 | 직원의 거주 국가입니다. 데이터 유형: 문자열 |
| 거주지우편번호 | 직원의 집 우편 번호입니다. 데이터 유형: 문자열 |
| 거주지 상태 | 직원의 홈 시/도입니다. 데이터 유형: 문자열 |
| 접미사 | 직원의 접미사(예: Mr., Mrs. 또는 Dr.) 데이터 유형: 문자열 |
| 작업 주소 | 직원의 직장 주소입니다. 데이터 유형: 문자열 |
| 워크시티 | 직원의 근무 도시 데이터 유형: 문자열 |
| 작업 국가 | 직원의 근무 국가입니다. 데이터 유형: 문자열 |
| 작업 우편번호 | 직원의 직장 우편 번호입니다. 데이터 유형: 문자열 |
| 작업 상태 | 직원의 작업 상태입니다. 데이터 유형: 문자열 |
[ ]

### 특정 직원의 정보에 대한 샘플 cURL 요청

    curl -X GET "https://instance.servicenow.com/api/sn_hr_core/V1/hr_rest_api/get_usa_employee_profile?employee_identifier=231"
    -H "accept: application/json" \
    -u "username":"password"

    {"result": [
     {
      "EmployeeIdentifier": "231",
      "FirstName": "Harold",
      "MiddleName": "William",
      "LastName": "Lewis",
      "Suffix": "Mr.",
      "Email": "Howard.Lewis@example.com",
      "BirthDate": "",
      "HireDate": "2021-02-18",
      "Company": "ServiceNow Inc",
      "ResidenceAddress": "",
      "ResidenceCity": "SD",
      "ResidenceState": "CA",
      "ResidencePostalCode": "",
      "ResidenceCountry": "",
      "WorkAddress": "2617 South Robinson Avenue, Oklahoma City",
      "WorkCity": "Oklahoma",
      "WorkState": "OK",
      "WorkPostalCode": "73109",
      "WorkCountry": "USA",
      "ReHire": ""
     }
    ]}

### 2019년 5월 18일 또는 그 이후에 추가/업데이트된 직원 목록에 대한 샘플 cURL 요청

    curl -X GET "https://instance.servicenow.com/api/sn_hr_core/V1/hr_rest_api/get_usa_employee_profile?update_after=2019-05-18"
    -H "accept: application/json" \
    -u "username":"password"

    {"result": [
     {
      "EmployeeIdentifier": "2345",
      "FirstName": "Cheryl",
      "MiddleName": "Lynn",
      "LastName": "Smith",
      "Suffix": "Mrs.",
      "Email": "Cheryl.Smith@example.com",
      "BirthDate": "",
      "HireDate": "2019-06-18",
      "Company": "ServiceNow Inc",
      "ResidenceAddress": "",
      "ResidenceCity": "SD",
      "ResidenceState": "CA",
      "ResidencePostalCode": "",
      "ResidenceCountry": "",
      "WorkAddress": "2617 South Robinson Avenue, Oklahoma City",
      "WorkCity": "Oklahoma",
      "WorkState": "OK",
      "WorkPostalCode": "73109",
      "WorkCountry": "USA",
      "ReHire": ""
      },
      {
      "EmployeeIdentifier": "1111",
      "FirstName": "Thomas",
      "MiddleName": "",
      "LastName": "Doe",
      "Suffix": "Mr.",
      "Email": "Thomas.Doe@example.com",
      "BirthDate": "1978-05-22",
      "HireDate": "2019-08-14",
      "Company": "",
      "ResidenceAddress": "",
      "ResidenceCity": "San Jose",
      "ResidenceState": "CA",
      "ResidencePostalCode": "",
      "ResidenceCountry": "",
      "WorkAddress": "13308 Midland Road, Poway",
      "WorkCity": "Poway",
      "WorkState": "CA",
      "WorkPostalCode": "",
      "WorkCountry": "USA",
      "ReHire": ""
      }
    ]}