1개의 조직에 대해 보류 중인 모든 청구서 반환

얻다 /api/atlas/v2/orgs/{orgId}/invoices/pending

지정된 조직의 현재 청구 주기에 대해 비용이 발생한 모든 청구서를 반환합니다. 이 리소스를 사용하려면, 요청하는 서비스 계정 또는 API 키에 조직 청구 뷰어, 조직 청구 관리자 또는 조직 소유자 역할이 있어야 합니다. 조직 간 설정이 있는 경우, 조직 청구 관리자 또는 조직 소유자 역할이 있으면 연결된 청구서를 볼 수 있습니다.

경로 매개변수

  • orgId 문자열 필수 사항

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

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

쿼리 매개변수

  • envelope 부울

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

    기본값은 false 입니다.

  • pretty 부울

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

    기본값은 false 입니다.

    Prettyprint

응답

  • 200 application/vnd.atlas.2023-01-01+json

    확인

    응답 속성 숨기기 응답 속성 표시 객체
    • 결과 배열[객체]

      이 요청 을 완료할 때 MongoDB 클라우드가 제공하는 반환된 문서 목록입니다.

      결과 속성 숨기기 결과 속성 표시 객체
      • 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})$ 패턴 과 일치해야 합니다.

      • 라인 항목 배열[객체]

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

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

        품목 속성 숨기기 품목 속성 표시 객체
        • 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달러의 0분의 1)로 표현하고 unitPriceDollars × 수량 × 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 타임스탬프 형식으로 값을 표현합니다.

    • 총 개수 integer(int32)

      사용 가능한 총 문서 수입니다. MongoDB Cloud는 includeCountfalse로 설정하다 경우 이 값을 생략합니다. 총 숫자는 추정치이며 정확하지 않을 수 있습니다.

      최소값은 0입니다.

  • 401 application/json

    승인되지 않았습니다.

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

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

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

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

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

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

        • 필드 문자열 필수 사항

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

    • 세부 정보 문자열

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

    • 오류 integer(int32) 필수 사항

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

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

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

    • 매개변수 배열[객체]

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

    • 이유 문자열

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

  • 403 application/json

    Forbidden.

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

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

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

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

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

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

        • 필드 문자열 필수 사항

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

    • 세부 정보 문자열

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

    • 오류 integer(int32) 필수 사항

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

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

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

    • 매개변수 배열[객체]

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

    • 이유 문자열

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

  • 404 application/json

    찾을 수 없습니다.

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

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

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

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

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

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

        • 필드 문자열 필수 사항

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

    • 세부 정보 문자열

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

    • 오류 integer(int32) 필수 사항

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

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

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

    • 매개변수 배열[객체]

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

    • 이유 문자열

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

  • 500 application/json

    내부 서버 오류입니다.

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

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

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

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

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

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

        • 필드 문자열 필수 사항

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

    • 세부 정보 문자열

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

    • 오류 integer(int32) 필수 사항

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

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

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

    • 매개변수 배열[객체]

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

    • 이유 문자열

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

GET /API/Atlas/v2/orgs/{orgId}/invoices/pending
atlas api invoices listInvoicePending --help
import (
	"os"
	"context"
	"log"
	sdk "go.mongodb.org/atlas-sdk/v20250312001/admin"
)

func main() {
	ctx := context.Background()
	clientID := os.Getenv("MONGODB_ATLAS_CLIENT_ID")
	clientSecret := os.Getenv("MONGODB_ATLAS_CLIENT_SECRET")

	// See https://dochub.mongodb.org/core/atlas-go-sdk-oauth
	client, err := sdk.NewClient(sdk.UseOAuthAuth(clientID, clientSecret))

	if err != nil {
		log.Fatalf("Error: %v", err)
	}

	params = &sdk.ListOrgInvoicePendingApiParams{}
	sdkResp, httpResp, err := client.InvoicesApi.
		ListOrgInvoicePendingWithParams(ctx, params).
		Execute()
}
curl --include --header "Authorization: Bearer ${ACCESS_TOKEN}" \
  --header "Accept: application/vnd.atlas.2025-03-12+json" \
  -X GET "https://cloud.mongodb.com/api/atlas/v2/orgs/{orgId}/invoices/pending?pretty=true"
curl --user "${PUBLIC_KEY}:${PRIVATE_KEY}" \
  --digest --include \
  --header "Accept: application/vnd.atlas.2025-03-12+json" \
  -X GET "https://cloud.mongodb.com/api/atlas/v2/orgs/{orgId}/invoices/pending?pretty=true"
응답 예시(200)
{
  "links": [
    {
      "href": "https://cloud.mongodb.com/api/atlas",
      "rel": "self"
    }
  ],
  "results": [
    {
      "amountBilledCents": 42,
      "amountPaidCents": 42,
      "created": "2026-05-04T09:42:00Z",
      "creditsCents": 42,
      "endDate": "2026-05-04T09:42:00Z",
      "id": "32b6e34b3d91647abb20e7b8",
      "lineItems": [
        {
          "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"
    }
  ],
  "totalCount": 42
}
응답 예시(401)
{
  "error": 401,
  "detail": "(This is just an example, the exception may not be related to this endpoint)",
  "reason": "Unauthorized",
  "errorCode": "NOT_ORG_GROUP_CREATOR"
}
응답 예시(403)
{
  "error": 403,
  "detail": "(This is just an example, the exception may not be related to this endpoint)",
  "reason": "Forbidden",
  "errorCode": "CANNOT_CHANGE_GROUP_NAME"
}
응답 예시(404)
{
  "error": 404,
  "detail": "(This is just an example, the exception may not be related to this endpoint) Cannot find resource AWS",
  "reason": "Not Found",
  "errorCode": "RESOURCE_NOT_FOUND"
}
응답 예시(500)
{
  "error": 500,
  "detail": "(This is just an example, the exception may not be related to this endpoint)",
  "reason": "Internal Server Error",
  "errorCode": "UNEXPECTED_ERROR"
}