1개의 조직에 대해 1개의 청구서 반환

얻다 /api/atlas/v1.0/orgs/{orgId}/invoices/{invoiceId}

MongoDB가 지정된 조직에 발행한 하나의 청구서를 반환합니다. 고유한 24자리 16진수 문자열로 청구서를 식별합니다. 이 청구서를 JSON 또는 CSV 형식으로 수신하도록 선택할 수 있습니다. 조직 간 설정이 있는 경우, 조직 청구 관리자 또는 조직 소유자 역할이 있으면 연결된 청구서를 쿼리할 수 있습니다. 청구서의 총 미지급 금액을 계산하려면 청구서에 포함된 각 결제의 총 미지급 금액을 합산합니다. 결제의 미지급 금액을 계산하려면 totalBilledCents * unitPrice + salesTax - startingBalanceCents 수식을 사용하세요.

역할 요구 사항
  • 조직 청구 뷰어

경로 매개변수

  • orgId 문자열 필수 사항

    프로젝트가 포함된 조직 식별하는 고유한 24-16진수 string입니다. /orgs 엔드포인트를 사용하여 인증된 사용자가 액세스 할 수 있는 모든 조직을 조회 .

    형식은 ^([a-f0-9]{24})$ 패턴 과 일치해야 합니다.

  • invoiceId 문자열 필수 사항

    지정된 조직에 제출된 청구서를 식별하는 고유한 24자리 16진수 문자열입니다. 요금은 일반적으로 다음 날 청구됩니다.

    형식은 ^([a-f0-9]{24})$ 패턴 과 일치해야 합니다.

쿼리 매개변수

  • envelope 부울

    애플리케이션이 응답을 envelope JSON 객체로 래핑할지 여부를 나타내는 플래그입니다. 일부 API 클라이언트는 HTTP 응답 헤더 또는 상태 코드에 액세스할 수 없습니다. 이 문제를 해결하려면 쿼리에서 envelope=true를 설정합니다. 결과 목록을 반환하는 엔드포인트는 결과 객체를 엔벨로프로 사용합니다. 애플리케이션은 응답 본문에 상태 매개변수를 추가합니다.

    기본값은 false 입니다.

  • pretty 부울

    응답 본문이 프리티프린트 형식이어야 하는지 여부를 나타내는 플래그입니다.

    기본값은 false 입니다.

    Prettyprint

응답

  • 확인

    응답 속성 숨기기 응답 속성 표시 객체
    • amountBilledCents integer(int64)

      이 청구서에 포함된 기간 동안 지정된 조직 사용한 서비스의 합계입니다. 이 매개변수는 값을 센트(1100미국 달러의 0분의 1) 단위로 표현합니다.

    • amountPaidCents integer(int64)

      지정된 조직 이 청구서에 대해 지불한 합계입니다. 이 매개변수는 값을 센트(1100미국 달러의 0분의 1) 단위로 표현합니다.

    • 생성됨 문자열(날짜-시간)

      MongoDB Cloud에서 이 청구서를 생성한 날짜 및 시간입니다. 이 매개변수는 UTC의 ISO 8601 타임스탬프 형식으로 값을 표현합니다.

    • 크레딧센트 integer(int64)

      MongoDB 이 청구서에 지정된 조직 에 크레딧을 적용한 합계입니다. 이 매개변수는 값을 센트(1100미국 달러의 0분의 1) 단위로 표현합니다.

    • endDate 문자열(날짜-시간)

      MongoDB Cloud가 이 청구서에 포함된 청구 기간을 종료한 날짜 및 시간입니다. 이 매개변수는 UTC의 ISO 8601 타임스탬프 형식으로 값을 표현합니다.

    • id 문자열

      지정된 조직에 제출된 청구서를 식별하는 고유한 24자리 16진수 문자열입니다. 요금은 일반적으로 다음 날 청구됩니다.

      형식은 ^([a-f0-9]{24})$ 패턴 과 일치해야 합니다.

    • 라인 항목 배열[객체]

      이 청구서에 포함된 개별 서비스가 포함된 목록입니다.

      품목 속성 숨기기 품목 속성 표시 객체

      이 청구서에는 하나의 서비스가 포함되어 있습니다.

      • cloudProvider 문자열

        이 항목의 사용량이 속한 클라우드 공급자를 식별하는 코드입니다. 값은 다음과 같이 매핑됩니다. Amazon Web Services는 AWS, GCP는 Google Cloud, Azure는 Microsoft Azure, Atlas는 특정 클라우드 공급자에 연결되지 않은 기타 Atlas 사용량입니다.

        값은 AWS, GCP, AZURE 또는 ATLAS입니다.

      • clusterName 문자열

        요금이 발생한 클러스터 식별하는 인간 판독 가능 레이블.

        형식은 ^[a-zA-Z0-9][a-zA-Z0-9-]*$ 패턴 과 일치해야 합니다.

      • 생성됨 문자열(날짜-시간)

        MongoDB Cloud가 이 항목을 생성한 날짜 및 시간입니다. 이 매개변수는 UTC의 ISO 8601 타임스탬프 형식으로 값을 표현합니다.

      • 할인 센터 integer(int64)

        MongoDB 이 항목을 할인한 합계입니다. MongoDB Cloud는 이 값을 센트(1100미국 달러의 0분의 1) 단위로 표현합니다. 리소스 할인이 적용될 때 이 매개변수를 반환합니다.

      • endDate 문자열(날짜-시간)

        MongoDB Cloud가 이 항목에 대한 요금 청구를 완료한 날짜 및 시간입니다. 이 매개변수는 UTC의 ISO 8601 타임스탬프 형식으로 값을 표현합니다.

      • groupId 문자열

        이 항목과 연결된 프로젝트 식별하는 고유한 24-16진수 문자열입니다.

        형식은 ^([a-f0-9]{24})$ 패턴 과 일치해야 합니다.

      • groupName 문자열

        프로젝트를 식별하는 사람이 읽을 수 있는 레이블입니다.

      • 참고 문자열

        이 항목에 적용되는 주석입니다.

      • percentDiscount number(float)

        MongoDB 이 항목을 할인한 비율입니다. 리소스 할인이 적용될 때 이 매개변수를 반환합니다.

      • 수량 number(double)

        항목에 포함된 단위 수입니다. 저장 (GB), 시간(시간) 또는 기타 단위의 표현식일 수 있습니다.

      • sku 문자열

        이 항목이 제공한 서비스에 대한 사람이 읽을 수 있는 설명입니다. 이 SKU(Stock Keeping Unit)는 인스턴스 유형, 지원 요금, 고급 보안 또는 기타 서비스일 수 있습니다.

        가능한 모든 항목을 나열하는 방법을 보려면...
      • startDate 문자열(날짜-시간)

        MongoDB Cloud가 이 항목에 요금을 부과하기 시작한 날짜 및 시간입니다. 이 매개변수는 UTC의 ISO 8601 타임스탬프 형식으로 값을 표현합니다.

      • 스티치 앱 이름 문자열

        이 항목과 연결된 Atlas App Services 애플리케이션 식별하는 사람이 읽을 수 있는 레이블입니다.

        새 Atlas App Service 만들기
      • tags 객체

        항목 리소스 와 연결된 태그에 해당하는 키-값 쌍의 맵입니다.

        Hide tags attribute Show tags attribute 객체
        • * array[string] additionalProperties

          항목 리소스 와 연결된 태그에 해당하는 키-값 쌍의 맵입니다.

      • tierLowerBound number(double)

        현재 SKU 계층 의 사용량 범위 에 대한 하한입니다.

        참고: lineItems[n].tierLowerBound 는 lineItems[n].sku 이 계층화된 경우에만 표시됩니다.

      • tierUpperBound number(double)

        현재 SKU 계층 의 사용량 범위 에 대한 상한입니다.

        참고: lineItems[n].tierUpperBound 는 lineItems[n].sku 이 계층화된 경우에만 표시됩니다.

      • totalPriceCents integer(int64)

        이 항목에 대해 설정하다 비용 의 합계입니다. MongoDB Cloud는 이 값을 센트(100분의 1 미국 달러) 단위로 표현하고 unitPriceDollars * quantity * 100로 계산합니다.

      • 단위 문자열

        이 항목이 측정하는 수량을 표현하는 데 사용되는 요소입니다. 이 값은 시간, 저장 용량 등의 요소일 수 있습니다.

      • unitPriceDollars number(double)

        미국 달러로 표시되는 이 항목의 단위당 값입니다.

    • 연결된 청구서 배열[객체]

      지불 조직 에 연결된 조직의 청구서가 포함된 목록입니다.

    • orgId 문자열

      MongoDB Cloud에서 사용한 서비스에 대해 요금이 부과되는 조직 식별하는 고유한 24-16진수 문자열입니다.

      형식은 ^([a-f0-9]{24})$ 패턴 과 일치해야 합니다.

    • 지불 배열[객체]

      이 청구서에 명시된 특정 서비스를 충당하기 위해 MongoDB 로 이체된 자금이 포함된 목록입니다.

      결제 속성 숨기기 결제 속성 표시 객체

      이 청구서에 지정된 서비스를 충당하기 위해 MongoDB 로 이체된 자금입니다.

      • amountBilledCents integer(int64)

        이 청구서에 포함된 기간 동안 지정된 조직 사용한 서비스의 합계입니다. 이 매개변수는 값을 센트(1100미국 달러의 0분의 1) 단위로 표현합니다.

      • amountPaidCents integer(int64)

        지정된 조직 관련 청구서에 대해 지불한 합계입니다. 이 매개변수는 값을 센트(1100미국 달러의 0분의 1) 단위로 표현합니다.

      • 생성됨 문자열(날짜-시간)

        고객이 결제를 시도한 날짜 및 시간입니다. 이 매개변수는 UTC의 ISO 8601 타임스탬프 형식으로 값을 표현합니다.

      • 통화 문자열

        결제에 사용한 통화입니다. 이 매개변수는 값을 3-문자 ISO 4217 통화 코드로 표현합니다.

      • id 문자열

        관련 청구서에서 이 결제를 식별하는 고유한 24-16진수 문자열입니다.

        형식은 ^([a-f0-9]{24})$ 패턴 과 일치해야 합니다.

      • SalesTaxCents integer(int64)

        이 청구서에 적용된 판매세의 합계입니다. 이 매개변수는 값을 센트(1100미국 달러의 0분의 1) 단위로 표현합니다.

      • statusName 문자열

        이 요청 한 시점의 관련 청구서에 대한 결제 처리 단계입니다. 이러한 단계에는 다음이 포함됩니다.

        • CANCELLED: 고객 또는 MongoDB 결제를 취소했습니다.
        • ERROR: 결제를 완료하려고 할 때 문제가 발생했습니다.
        • FAILED: MongoDB 크레딧 카드로 청구하려고 시도했지만 성공.
        • FAILED_AUTHENTICATION: Strong Customer Authentication(강력 고객 인증)에 실패했습니다. 결제 수단이 인증되었는지 확인합니다.
        • FORGIVEN: 고객 결제를 시작했지만 나중에 MongoDB 에서 면제되었습니다.
        • INVOICED: MongoDB 이 항목이 포함된 청구서를 발행했습니다.
        • NEW: 고객 결제 수단을 제공했지만 MongoDB 크레딧 카드로 청구를 시도하지 않았습니다.
        • PAID: 고객 성공적인 결제를 제출했습니다.
        • PARTIAL_PAID: 고객 이 항목의 일부에 대해 비용을 지불했습니다.

        값은 NEW, FORGIVEN, FAILED, PAID, PARTIAL_PAID, CANCELLED, INVOICED, FAILED_AUTHENTICATION, PROCESSING, PENDING_REVERSAL 또는 REFUNDED입니다.

      • subtotalCents integer(int64)

        이 청구서에 포함된 모든 양수 청구서 항목의 합계입니다. 이 매개변수는 값을 센트(1100미국 달러의 0분의 1) 단위로 표현합니다.

      • unitPrice 문자열

        총 결제 금액을 계산하기 위해 amountBilledCents 에 적용된 단가입니다. 이 값은 10진수 문자열로 표시됩니다.

      • Updated 문자열(날짜-시간)

        고객이 이 결제 시도를 업데이트 한 날짜 및 시간입니다. 이 매개변수는 UTC의 ISO 8601 타임스탬프 형식으로 값을 표현합니다.

    • 환불 배열[객체]

      이 청구서에 대해 MongoDB 조직 에 반환한 결제 내역이 포함된 목록입니다.

      환불 속성 숨기기 환불 속성 표시 객체

      이 청구서에 대해 MongoDB 조직 에 반환한 결제 1건입니다.

      • amountCents integer(int64)

        지정된 조직 으로 반환된 자금의 합계로, 센트(미국 달러의 100분의 1)로 표시됩니다.

      • 생성됨 문자열(날짜-시간)

        MongoDB 클라우드가 이 환불을 생성한 날짜 및 시간입니다. 이 매개변수는 UTC의 ISO 8601 타임스탬프 형식으로 값을 표현합니다.

      • PaymentId 문자열

        조직 에서 결제한 금액을 식별하는 고유한 24-16진수 문자열입니다.

        형식은 ^([a-f0-9]{24})$ 패턴 과 일치해야 합니다.

      • 이유 문자열

        MongoDB 조직 에 자금을 반환하기 위해 수락한 근거입니다.

    • SalesTaxCents integer(int64)

      이 청구서에 적용된 판매세의 합계입니다. 이 매개변수는 값을 센트(1100미국 달러의 0분의 1) 단위로 표현합니다.

    • startDate 문자열(날짜-시간)

      MongoDB Cloud가 이 청구서에 포함된 청구 기간을 시작한 날짜 및 시간입니다. 이 매개변수는 UTC의 ISO 8601 타임스탬프 형식으로 값을 표현합니다.

    • startupBalanceCents integer(int64)

      MongoDB 이 청구서를 발행했을 때 지정된 조직 MongoDB 에 지불해야 하는 금액의 합계입니다. 이 매개변수는 해당 값을 미국 달러로 표현합니다.

    • statusName 문자열

      이 요청 할 때 이 청구서가 존재했던 결제 처리 단계입니다. 허용되는 단계는 다음과 같습니다.

      • CLOSED: MongoDB 청구 주기의 모든 요금 청구를 확정했지만 아직 고객에게 요금을 청구하지 않았습니다.
      • FAILED: MongoDB 제공된 크레딧 카드로 청구를 시도했지만 해당 금액에 대한 청구가 실패했습니다.
      • FORGIVEN: 고객 결제를 시작했지만 나중에 MongoDB 에서 면제되었습니다.
      • FREE: 모든 요금의 합계가 0이므로 고객에게 요금이 청구되지 않습니다.
      • INVOICED: MongoDB 탄력적 청구서를 사용하여 이러한 요금을 처리했습니다.
      • PAID: MongoDB 제공된 크레딧 카드로 청구에 성공했습니다.
      • PENDING: 청구서에는 현재 청구 주기에 대한 요금이 포함되어 있습니다.
      • PREPAID: 고객 선불 요금제를 사용 중이므로 요금이 청구되지 않습니다.

      값은 PENDING, CLOSED, FORGIVEN, FAILED, PAID, FREE, PREPAID 또는 INVOICED입니다.

    • subtotalCents integer(int64)

      이 청구서에 포함된 모든 양수 청구서 항목의 합계입니다. 이 매개변수는 값을 센트(1100미국 달러의 0분의 1) 단위로 표현합니다.

    • Updated 문자열(날짜-시간)

      MongoDB Cloud가 이 결제 금액을 마지막으로 업데이트한 날짜 및 시간입니다. 이 매개변수는 UTC의 ISO 8601 타임스탬프 형식으로 값을 표현합니다.

  • 401 application/json

    승인되지 않았습니다.

    응답 속성 숨기기 응답 속성 표시 객체
    • badRequestDetail 객체

      요청 세부 정보가 잘못되었습니다.

      badRequestDetail 속성 숨기기 badRequestDetail 속성 표시 객체
      • 필드 배열[객체]

        클라이언트 요청 의 모든 위반 사항을 설명합니다.

        필드 속성 숨기기 필드 속성 표시 객체
        • description 문자열 필수 사항

          요청 요소가 잘못된 이유에 대한 설명입니다.

        • 필드 문자열 필수 사항

          요청 본문의 필드 로 연결되는 경로입니다.

    • 세부 정보 문자열 | null

      각 오류 유형을 유발하는 특정 조건 또는 이유를 설명합니다.

    • 오류 integer(int32) 필수 사항

      이 오류와 함께 HTTP 상태 코드가 반환되었습니다.

      외부 문서
    • 오류 코드 문자열 필수 사항

      이 오류와 함께 반환된 애플리케이션 오류 코드입니다.

    • 매개변수 배열[객체]

      오류에 대한 자세한 정보를 제공하는 데 사용된 매개변수입니다.

    • 이유 문자열 | null

      이 오류와 함께 반환된 애플리케이션 오류 메시지입니다.

  • 403 application/json

    Forbidden.

    응답 속성 숨기기 응답 속성 표시 객체
    • badRequestDetail 객체

      요청 세부 정보가 잘못되었습니다.

      badRequestDetail 속성 숨기기 badRequestDetail 속성 표시 객체
      • 필드 배열[객체]

        클라이언트 요청 의 모든 위반 사항을 설명합니다.

        필드 속성 숨기기 필드 속성 표시 객체
        • description 문자열 필수 사항

          요청 요소가 잘못된 이유에 대한 설명입니다.

        • 필드 문자열 필수 사항

          요청 본문의 필드 로 연결되는 경로입니다.

    • 세부 정보 문자열 | null

      각 오류 유형을 유발하는 특정 조건 또는 이유를 설명합니다.

    • 오류 integer(int32) 필수 사항

      이 오류와 함께 HTTP 상태 코드가 반환되었습니다.

      외부 문서
    • 오류 코드 문자열 필수 사항

      이 오류와 함께 반환된 애플리케이션 오류 코드입니다.

    • 매개변수 배열[객체]

      오류에 대한 자세한 정보를 제공하는 데 사용된 매개변수입니다.

    • 이유 문자열 | null

      이 오류와 함께 반환된 애플리케이션 오류 메시지입니다.

  • 404 application/json

    찾을 수 없습니다.

    응답 속성 숨기기 응답 속성 표시 객체
    • badRequestDetail 객체

      요청 세부 정보가 잘못되었습니다.

      badRequestDetail 속성 숨기기 badRequestDetail 속성 표시 객체
      • 필드 배열[객체]

        클라이언트 요청 의 모든 위반 사항을 설명합니다.

        필드 속성 숨기기 필드 속성 표시 객체
        • description 문자열 필수 사항

          요청 요소가 잘못된 이유에 대한 설명입니다.

        • 필드 문자열 필수 사항

          요청 본문의 필드 로 연결되는 경로입니다.

    • 세부 정보 문자열 | null

      각 오류 유형을 유발하는 특정 조건 또는 이유를 설명합니다.

    • 오류 integer(int32) 필수 사항

      이 오류와 함께 HTTP 상태 코드가 반환되었습니다.

      외부 문서
    • 오류 코드 문자열 필수 사항

      이 오류와 함께 반환된 애플리케이션 오류 코드입니다.

    • 매개변수 배열[객체]

      오류에 대한 자세한 정보를 제공하는 데 사용된 매개변수입니다.

    • 이유 문자열 | null

      이 오류와 함께 반환된 애플리케이션 오류 메시지입니다.

  • 500 application/json

    내부 서버 오류입니다.

    응답 속성 숨기기 응답 속성 표시 객체
    • badRequestDetail 객체

      요청 세부 정보가 잘못되었습니다.

      badRequestDetail 속성 숨기기 badRequestDetail 속성 표시 객체
      • 필드 배열[객체]

        클라이언트 요청 의 모든 위반 사항을 설명합니다.

        필드 속성 숨기기 필드 속성 표시 객체
        • description 문자열 필수 사항

          요청 요소가 잘못된 이유에 대한 설명입니다.

        • 필드 문자열 필수 사항

          요청 본문의 필드 로 연결되는 경로입니다.

    • 세부 정보 문자열 | null

      각 오류 유형을 유발하는 특정 조건 또는 이유를 설명합니다.

    • 오류 integer(int32) 필수 사항

      이 오류와 함께 HTTP 상태 코드가 반환되었습니다.

      외부 문서
    • 오류 코드 문자열 필수 사항

      이 오류와 함께 반환된 애플리케이션 오류 코드입니다.

    • 매개변수 배열[객체]

      오류에 대한 자세한 정보를 제공하는 데 사용된 매개변수입니다.

    • 이유 문자열 | null

      이 오류와 함께 반환된 애플리케이션 오류 메시지입니다.

GET /api/atlas/v1.0/orgs/{orgId}/invoices/{invoiceId}
curl \
 --request GET 'https://cloud.mongodb.com/api/atlas/v1.0/orgs/4888442a3354817a7320eb61/invoices/{invoiceId}' \
 --header "Authorization: Bearer $ACCESS_TOKEN"
응답 예시(200)
{
  "amountBilledCents": 42,
  "amountPaidCents": 42,
  "created": "2026-05-04T09:42:00Z",
  "creditsCents": 42,
  "endDate": "2026-05-04T09:42:00Z",
  "id": "32b6e34b3d91647abb20e7b8",
  "lineItems": [
    {
      "cloudProvider": "AWS",
      "clusterName": "string",
      "created": "2026-05-04T09:42:00Z",
      "discountCents": 42,
      "endDate": "2026-05-04T09:42:00Z",
      "groupId": "32b6e34b3d91647abb20e7b8",
      "groupName": "string",
      "note": "string",
      "percentDiscount": 42.0,
      "quantity": 42.0,
      "sku": "string",
      "startDate": "2026-05-04T09:42:00Z",
      "stitchAppName": "string",
      "tags": {
        "additionalProperty1": [
          "string"
        ],
        "additionalProperty2": [
          "string"
        ]
      },
      "tierLowerBound": 42.0,
      "tierUpperBound": 42.0,
      "totalPriceCents": 42,
      "unit": "string",
      "unitPriceDollars": 42.0
    }
  ],
  "linkedInvoices": [
    {}
  ],
  "links": [
    {
      "href": "https://cloud.mongodb.com/api/atlas",
      "rel": "self"
    }
  ],
  "orgId": "32b6e34b3d91647abb20e7b8",
  "payments": [
    {
      "amountBilledCents": 42,
      "amountPaidCents": 42,
      "created": "2026-05-04T09:42:00Z",
      "currency": "string",
      "id": "32b6e34b3d91647abb20e7b8",
      "salesTaxCents": 42,
      "statusName": "NEW",
      "subtotalCents": 42,
      "unitPrice": "string",
      "updated": "2026-05-04T09:42:00Z"
    }
  ],
  "refunds": [
    {
      "amountCents": 42,
      "created": "2026-05-04T09:42:00Z",
      "paymentId": "32b6e34b3d91647abb20e7b8",
      "reason": "string"
    }
  ],
  "salesTaxCents": 42,
  "startDate": "2026-05-04T09:42:00Z",
  "startingBalanceCents": 42,
  "statusName": "PENDING",
  "subtotalCents": 42,
  "updated": "2026-05-04T09:42:00Z"
}
응답 예시(200)
Invoice Number,666acb8787ba43606905dcae,
Billing Period,"June 1, 2024 - July 1, 2024",
Organization Name,Test 2,
Organization ID,666acb8787ba43606905dcac,

Date,Usage Date,Description,Note,Organization Name,Organization ID,Project,Project ID,SKU,Region,Cluster,Replica Set,Config Server,Application,Unit,Unit Price,Quantity,Discount Percent,Amount
응답 예시(401)
{
  "detail": "(This is just an example, the exception may not be related to this endpoint)",
  "error": 401,
  "errorCode": "NOT_ORG_GROUP_CREATOR",
  "reason": "Unauthorized"
}
응답 예시(403)
{
  "detail": "(This is just an example, the exception may not be related to this endpoint)",
  "error": 403,
  "errorCode": "CANNOT_CHANGE_GROUP_NAME",
  "reason": "Forbidden"
}
응답 예시(404)
{
  "detail": "(This is just an example, the exception may not be related to this endpoint) Cannot find resource AWS",
  "error": 404,
  "errorCode": "RESOURCE_NOT_FOUND",
  "reason": "Not Found"
}
응답 예시(500)
{
  "detail": "(This is just an example, the exception may not be related to this endpoint)",
  "error": 500,
  "errorCode": "UNEXPECTED_ERROR",
  "reason": "Internal Server Error"
}