[create-pull-request] automated change (#958)

Co-authored-by: antoniobg <[email protected]>

Author: revenuecat-ops

openapi-spec/api-v2-beta.yaml

@@ -5078,6 +5078,88 @@ paths:
         \ this may include the `transactionId` of any transaction in an Apple App\
         \ Store subscription, or any order ID from a Google Play Store subscription.\n\
         \ This endpoint requires the following permission(s): <code>customer_information:subscriptions:read</code>."
+  /projects/{project_id}/purchases:
+    get:
+      summary: Search one-time purchases by store purchase identifier
+      operationId: search-purchases
+      x-revenuecat-rate-limiting-domain: customer_information
+      x-scopes:
+      - customer_information:purchases:read
+      x-release-status: beta
+      tags:
+      - Purchase
+      parameters:
+      - name: project_id
+        description: ID of the project
+        required: true
+        in: path
+        schema:
+          type: string
+          maxLength: 255
+          example: proj1ab2c3d4
+      - name: store_purchase_identifier
+        description: Store ID associated with the one-time purchase.
+        required: true
+        in: query
+        schema:
+          type: string
+          nullable: false
+          minLength: 1
+          maxLength: 255
+        examples:
+          amazon:
+            value: 9aJscueFTxLPZXXo-AlBTkI0OnFXR2qiH14C1aqWnOT=:3:11
+            summary: 'Amazon Appstore '
+          app_store:
+            value: '100001234567890'
+            summary: Apple App Store
+          paddle:
+            value: txn_01jss4bz50g1z5yw121npeb3ag
+            summary: Paddle
+          play_store:
+            value: GPA.1234-5678-9012-34567
+            summary: Google Play Store
+          rc_billing:
+            value: txRcb553a54d4738816a63f1a05cfcb1723e3
+            summary: RevenueCat Web Billing
+          roku:
+            value: 4ab8df12-3003-11f0-9646-8ac68bcdcaed
+            summary: Roku
+          stripe:
+            value: si_Rww1psqupbKxmt
+            summary: Stripe
+      responses:
+        '200':
+          description: Success
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/ListPurchases'
+          headers:
+            RevenueCat-Rate-Limit-Current-Usage:
+              $ref: '#/components/headers/RateLimitCurrentUsage'
+            RevenueCat-Rate-Limit-Current-Limit:
+              $ref: '#/components/headers/RateLimitCurrentLimit'
+        '400':
+          $ref: '#/components/responses/BadRequest'
+        '401':
+          $ref: '#/components/responses/Unauthorized'
+        '403':
+          $ref: '#/components/responses/Forbidden'
+        '404':
+          $ref: '#/components/responses/NotFound'
+        '423':
+          $ref: '#/components/responses/Locked'
+        '429':
+          $ref: '#/components/responses/RateLimited'
+        '500':
+          $ref: '#/components/responses/InternalError'
+        '503':
+          $ref: '#/components/responses/InternalError'
+      description: "Search for a one-time purchases by any of its associated `store_purchase_identifier`\
+        \ values.\n\nFor example, this may include the `transactionId` of any transaction\
+        \ in an Apple App Store purchase, or any order ID from a Google Play Store\
+        \ purchase.\n This endpoint requires the following permission(s): <code>customer_information:purchases:read</code>."
 components:
   securitySchemes:
     BearerAuth: